Skip to main content

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

ColumnTypeDescriptionExample
store_identifierStringSpecifies which store each flyer file belongs to."1"
flyer_starts_atStringSale start date (inclusive). Format is MM/DD/YYYY."06/12/2024"
flyer_ends_atStringSale end date (exclusive). Format is MM/DD/YYYY."06/19/2024"
flyer_urlStringURL link to the PDF file."https://www.retailer.com/flyer.pdf"
tagStringRepresents the type of flyer. Can be used as the name of the flyer."weekly"

Example assets file data

store_identifierflyer_starts_atflyer_ends_atflyer_urltag
40101/01/202501/31/2025https://www.retailer.com/flyer1.pdfmonthly
50101/01/202501/31/2025https://www.retailer.com/flyer2.pdfmonthly
60101/01/202501/31/2025https://www.retailer.com/flyer3.pdfmonthly

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

ColumnTypeDescriptionExample
versioncodeStringSpecifies the zones/regions."ny", "ncal"
storenumberIntegerDesignates which stores each flyer file belongs to.401, 402, 403
assetStringName of the PDF file."jan25_ny"

Example versions file data

versioncodestorenumberasset
ny401, 402, 403jan25_ny
mw501, 502, 503jan25_mw
ncal601, 602, 603jan25_ncal