Instagram Marketplace Product Feed Specifications

Comma-separated value.

• The first row specifies the column header. Subsequent rows supply the corresponding values for each route.
• Fields containing whitespace or commas should be enclosed in “double quotes”. A double quote inside a double-quoted field must be escaped with two consecutive double quotes. Example: “Join our “”Royal”” membership program”.
• Nested or multi-value fields, such as image, can be represented using JSON-encoded values or by a set of “flattened” plain-text columns labeled using JSON-path syntax. Example: image[0].url, image[0].tag[0], image[0].tag[1])
• Both conventions can be used interchangeably in the same file.

Unique ID for item. Can be a variant for a product. If you can, use the product’s existing SKU. If there are multiple instances of the same ID, we ignore all instances. This maps to retailer_id after the product is imported. Max characters: 100

Example: FB_product_0001

Product’s current availability. If item in stock, use one of these accepted values:

• in stock – Item ships immediately
• out of stock – No plan to restock
• preorder – Available in future
• available for order – Ships in 1-2 weeks
• discontinued – Discontinued

Example: in stock

Product’s current condition: new, refurbished, or used.

Example: new

Short text describing product. Don’t include promotional text or any links. Don’t enter text in all capital letters. Use line breaks or italics to format your description. Max size: 5000

Example: A vibrant crewneck for all shapes and sizes. Made from 100% cotton.

Link to item image used in the ad. Provide proper image sizes.

For square (1:1) aspect ratios in the carousel ad format – Your image should be 600×600. For single-image, dynamic ads – The min image resolution requirement is 1200×630. The min aspect ratio requirement is 4:5 and the maximum aspect ratio requirement is 1:91:1. If the image is outside this aspect ratio, Facebook crops it to be closest to either the minimum aspect ratio or the maximum aspect ratio depending on its original aspect ratio.

For carousel image, dynamic ads – The minimum image resolution requirement is 500px * 500px, and Facebook crops it to a 1:1 aspect ratio.

Example: https://www.facebook.com/t_shirt_image_001.jpg

URL link to merchant’s site (website landing page) where you can purchase the product or learn more about the item.

Example: https://www.facebook.com/t_shirt

Product title that’s relevant and specific to each product. Include keywords and variants, such as brand names, product areas, attributes, or condition. Max size: 150

Example: Blue Facebook T-Shirt (Unisex)

Cost and currency of item. Format price as the cost, followed by the ISO currency code, with a space between cost and currency.

Example: 9.99 USD, 25.00 EUR

Product’s Global Trade Item Number (GTINs). Exclude dashes and spaces. Submit only valid GTINs as defined by the GTIN validation buide. Supported values are UPC (North America, 12 digits), EAN (Europe, 13 digits), JAN (Japan, 8 or 13 digits), ISBN (books, 13 digits). Required for all new products with a GTIN assigned by the manufacturer.

Example: 4011200296908

Product’s unique manufacturer part number. Max characters: 100.

Example: 100020003

Product’s brand name. **Required if no manufacturer assigned gtin. Max characters: 100

Example: Facebook

Required. Determines whether item is in stock. Accepted values are:

• in stock – Item ships immediately
• out of stock – No plan to restock
• preorder – Available in future
• available for order – Ships in 1-2 weeks
• discontinued – Discontinued

Retailer-defined category for product. Max size: 750.

Example: in TSV
Home & Garden > Kitchen & Dining > Appliances > Refrigerators

Example: in XML <product_type>Home & Garden > Kitchen & Dining > Appliances > Refrigerators</product_type>

Start and end date and time for the sale, separated by slash:

2014-11-01T12:00-0300/2014-12-01T00:00-0300

Blob with different prices for each country and region. Different regions are comma-separated. The format should be COUNTRY:STATE:SHIPPING_TYPE:PRICE.

Example:

US:CA:Ground:9.99 USD, US:NY:Air:15.99 USD