Loyalty requirements
To offer discounts to loyalty members only, add the following columns. If a product is on sale and has loyalty pricing, a loyalty member receives the lowest price between the sale price and the loyalty price.
tip
Set the loyalty_end_at column to the date with which you want the discount to stop. If you leave the column empty, the discount continues forever.
| Column | Data type | Description | Example | Customer experience |
|---|---|---|---|---|
loyalty_cost_price_cents | float | Loyalty member price in cents.1 Loyalty prices must be less than cost_price_per_unit. A marked-up loyalty_price is never rounded. Loyalty price is considered a pass-through pricing field. Instacart does not modify the prices. 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 full image |
loyalty_cost_price_start_at | date (no timestamp) | Loyalty price 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 Time | None available |
loyalty_cost_price_end_at | date (no timestamp) | Loyalty price 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. | 10/22/2017 means 10/21/2017 11:59 PM Pacific Time. | None available |
Footnotes
-
For US stores, prices must be in USD. For Canada stores, prices must be in CAD. ↩