In-store product locations

To make it easy for shoppers and customers to find items in your store, provide the location details such as aisle, shelf, and department.

For Instacart shoppers

Instacart instructs shoppers to pick items in an order determined based on the item location and rank that you provide. The item location is also displayed in the Shopper app.

For customers

If your online storefront supports the in-store shopping context, item locations are displayed in the customer's shopping list and in the product details pages.

If you have Caper Carts in your store, item locations are displayed on the cart touchscreen in the customer's shopping list and in the product details pages.

Column

Column	Data type	Description	Example
location_data	JSON	The location of the product in a store.	See Example.

JSON data

All fields are optional.

Field Definitions	Type	Description	Example
aisle	string	Aisle number as displayed to customers in the store.	11F
area	string	Area of the store that is not divided into aisles.	Produce
department	string	Name of the department within an aisle.	Snacks
section	integer	Subdivision of an aisle. Usually, sections are horizontally separated and numerated from the front of the store to the back, or from left to right.	1
shelf	string	Shelf number or description, from bottom to top.	2A
rank	integer	Recommended shopping order value for Instacart shoppers. The smaller the value, the earlier an item needs to be shopped.	555
zone	string	Organizational segment within a store. For example, the produce department might contain a fruit zone, a vegetable zone, and an organic zone.	organic

Example

note

When you include a JSON object in a CSV file, you must use double quotes.

The following example shows how to define an item that is stocked at one location in a store:

{
    ""aisle"": ""Pantry"",
    ""shelf"": ""Cookies"",
    ""rank"": 2
}

The following example shows how to define an item that is stocked at multiple locations in a store:

[
    {
        ""aisle"": ""Pantry"",
        ""shelf"": ""1"",
        ""rank"": 2
    },
    {
        ""aisle"":"Bakery",
        ""department"":"Cookies",
        ""rank"": 555
    }
]