Skip to main content

Sales requirements

To create a sale on a single item, add the following columns. Sales are available to all customers.

warning

Be careful when combining a sale and a promotion. For more information, see Common promotion errors.

ColumnData typeDescriptionExampleCustomer experience
sale_price_centsfloatSale price in cents.1

The sale_price_cents must be less than cost_price_per_unit.

By default, the system expects values in cents. If you are sending dollar values, inform your Instacart representative. Instacart will configure the backend to support dollar values.
0.99

If you are sending dollar values and the cost is less than 1.00, you must include a zero before the decimal.
View sale price View full image
sale_start_atdate (no timestamp)Sale start date, in the format MM/DD/YYYY (inclusive).

The sale starts at 12:01 AM Pacific Time.
10/20/2023 means 10/20/2023 12:01 AM Pacific TimeNone available
sale_end_atdate (no timestamp)Sale end date, in the format MM/DD/YYYY (exclusive).

The sale ends at 11:59 PM Pacific Time on the day prior to your specified end date.

Important: Removing the end date does not remove a sale. To end a sale early you must change the end date first.
10/22/2017 means 10/21/2017 11:59 PM Pacific Time.None available

Sample CSV file

Download sample CSV file

Footnotes

  1. For US stores, prices must be in USD. For Canada stores, prices must be in CAD.