Skip to main content

Metadata file requirements

The metadata file contains a list of items featured in each store's flyer and the date range when the flyer is displayed on your storefront. This file can also include optional fields for enabling a shoppable flyer experience.

SFTP upload folder

sftp://sftp-partners.instacart.com/flyers

General attributes

ColumnTypeRequiredDescriptionExample
upcStringYesProduct identifier. Must match the upc value defined for this product in the catalog."00842096100802"
tagStringYesDescribes the type of flyer."weekly"
storenumberStringYesSpecifies which store a specific item belongs to. Must match the values defined in your warehouse data."1"
startdateStringYesSpecifies when the flyer is visible on your storefront. The timezone is set based automatically based on store location. Format is YYYY-MM-DD HH:MM:SS"2025-05-13 00:00:00" (beginning of the day)
enddateStringYesSpecifies when the flyer is no longer visible on your storefront. The timezone is set based automatically based on store location. Format is YYYY-MM-DD HH:MM:SS"2025Y-05-20 23:59:59" (end of the day)
localeStringNoSpecifies the language. Defaults to en_US if not provided."en_CA"

Shoppable attributes

To enable a shoppable flyer experience, include the following attributes in your metadata file.

ColumnTypeRequired?DescriptionExampleCustomer experience
activityidStringYesAssign the same activity ID to related products so they are displayed within the same "block" on the flyer page. For more information, see Flyers in the Instacart Platform Portal documentation.
Work with your IT department and Instacart representative to determine whether any of the attributes you currently use for grouping promotions should be sent as the activity ID.
"20230101_12345"Shows an example of a promotion as displayed to customers on a weekly flyer. View full image
pagenumberIntegerYesSpecifies the page of the print flyer where this promotion is located. Can be used to help identify top deals.1
promotitleStringYesPrimary copy displayed for the promotion. This value typically describes the offer or incentive, such as "2 for $5.""2 for $5"Shows an example of a promotion title as displayed to customers on a weekly flyer. View full image
promodescriptionStringNoSecondary copy displayed for the promotion. This value is typically a description of the eligible items. If the value is not provided in your data file, a description is automatically generated based on the product names."Arizona Iced Teas"Shows an example of a promotion description as displayed to customers on a weekly flyer. View full image