Flyer data requirements
In addition to the flyer metadata file, you must provide Instacart with your flyer data, including your print flyer PDFs and data for mapping flyers to stores. You can choose one of two options for sharing flyer data.
Option 1: Assets file and remotely hosted PDFs
If your flyer PDF files are remotely accessible, you can provide an assets file that specifies the flyer URLs, store mappings, and start and end dates for flyer deals.
SFTP upload folder
sftp://sftp-partners.instacart.com/flyers-assets
Assets file attributes
Column | Type | Description | Example |
---|---|---|---|
store_identifier | String | Specifies which store each flyer file belongs to. | "1" |
flyer_starts_at | String | Sale start date (inclusive). Format is MM/DD/YYYY. | "06/12/2024" |
flyer_ends_at | String | Sale end date (exclusive). Format is MM/DD/YYYY. | "06/19/2024" |
flyer_url | String | URL link to the PDF file. | "https://www.retailer.com/flyer.pdf" |
tag | String | Represents the type of flyer. Can be used as the name of the flyer. | "weekly" |
Example assets file data
store_identifier | flyer_starts_at | flyer_ends_at | flyer_url | tag |
---|---|---|---|---|
401 | 01/01/2025 | 01/31/2025 | https://www.retailer.com/flyer1.pdf | monthly |
501 | 01/01/2025 | 01/31/2025 | https://www.retailer.com/flyer2.pdf | monthly |
601 | 01/01/2025 | 01/31/2025 | https://www.retailer.com/flyer3.pdf | monthly |
Option 2: Versions file and uploaded PDFs
You can provide information about your print flyers by uploading the PDF files directly to Instacart. If you provide more than one PDF file, you must also provide a version file that maps flyers to stores. This option requires backend customization and extra lead time for implementation. For more information, contact your Instacart representative.
SFTP upload folders
- Flyer PDFs.
sftp://sftp-partners.instacart.com/adhoc-transfers/flyer_pdfs
- Versions files.
sftp://sftp-partners.instacart.com/adhoc-transfers/flyer_versions
Versions file attributes
Column | Type | Description | Example |
---|---|---|---|
versioncode | String | Specifies the zones/regions. | "ny", "ncal" |
storenumber | Integer | Designates which stores each flyer file belongs to. | 401, 402, 403 |
asset | String | Name of the PDF file. | "jan25_ny" |
Example versions file data
versioncode | storenumber | asset |
---|---|---|
ny | 401, 402, 403 | jan25_ny |
mw | 501, 502, 503 | jan25_mw |
ncal | 601, 602, 603 | jan25_ncal |