Column Names & Descriptions

Required Product Metadata

id

Customer’s product identifier.

Unique alphanumeric string

– Max 128 characters

– Must be unique across catalog

Must match the item_ids passed back in the pixel for Dynamic Ads Retargeting.

title

Description of the product.

String

– Max 375 characters

Title and Price can be pulled onto the ad. Title can be up to three lines on the ad. We recommend that the title be no more than ~40 characters to ensure it is not truncated on the ad

description

String
-Max 5000 characters

link

String

– Max Character Limit: 2,000

Link to the product page

– http or https

– Use an encoded URL that complies with RFC 2396 or RFC 1738. For example, a comma would be represented as “%2C”

image_link

Link to an image of the product

– http or https

– Use an encoded URL that complies with RFC 2396 or RFC 1738. For example, a comma would be represented as “%2C”

– Images must be either jpeg or png. gifs are not supported by the platform

– Images width >= 200px

– Image height >= 200px

availability

Availability of the product

String

Supported values:

– In stock

– Out of stock

– Preorder

– Discontinued

– Available for order

Out of Stock ads will be auto-excluded

price

Price of the product

String

– Expected Format: 199 USD. USD 199 also accepted

– Price cannot be null

– Price can be zero 0.00

– Currency may be provided if not USD

Title and Price will be pulled into the ad by default. Please provide currency in this field if not USD.

condition

The condition of your product at time of sale

String

– New: brand new, original, unopened packaging

– Refurbished: professionally restored to working order, comes with a warranty, may or may not have the original packaging

– Used: previously used, original packaging opened or missing

brand, gtin, or mpn

String

– Brand: Max 70 characters

– gtin: Max 70 alphanumeric characters

– mpn: Max 50 numeric characters

– Only one of the following – brand, gtin or mpn – are required

– Spaces, dashes accepted, but ignored

– gtin – Global Trade Item Number (GTINs) can include UPC, EAN, JAN, and ISBN.

– mpn – Unique manufacturer ID for product

– brand – Name of the brand

Global Trade ID number

– UPC (in North America / GTIN-12)

– 12-digit number like 323456789012

– 8-digit UPC-E codes should be converted to 12-digit codes

– EAN (in Europe / GTIN-13)

– 13-digit number like 3001234567892

– JAN (in Japan / GTIN-13)

– 8 or 13-digit number like 49123456 or 4901234567894

– ISBN (for books)

– 10 or 13-digit number like 1455582344 or 978-1455582341. If you have both, only include the 13-digit number. ISBN-10 are deprecated and should be converted to ISBN-13

– ITF-14 (for multipacks / GTIN-14)

– 14-digit number like 10856435001702

Manufacturer Part Number

– Max 50 numeric characters

Optional Product Metadata

age_group

Product’s targeted age group

String

Supported values:

– Newborn

– Infant

– Toddler

– Kid

– Adult

color

Colour of the product

gender

Product’s targeted gender

String

Supported values: Male, Female, Unisex

item_group_id

Id of products that come in different sizes/materials. If matching on item_group_id (as opposed to item_ids for Dynamic Ads Retargeting) this value must match the item_category passed back in the pixel.

google_product_category

Product category based on the Google product taxonomy

product_type

Product category that you define for your product

String

– Max character limit: 750

– Max count of unique product types: 10

adult

Whether product contains adult content

String

Supported values:

– Yes

– No

custom_label_0 (1-4)

Additional information about item

String

– Max Character Limit: 100

size

Products Size

String

– Max Character Limit: 100

additional_image_link

Additional URL link to an image of the product

String

– Max character limit: 2000

sale_price

Price of product on sale

String

– Expected Format: 199 USD. USD 199 also accepted

-Price cannot be null

– Price can be zero 0.00

– Currency may be provided in a separate column

sale_price_effective_date

Date range when sale_price becomes effective

String

Format:

– Date range (use ISO 8601 standard).

– Submit a start date and an end date separated by slash ( / )

e.g. 2016-02-24T13:00-0800/2016-02-29T15:30-0800

address

Latitude and Longitude Coordinates indicating where product is available

String Format: Latitude and Longitude Coordinates Value:{“latitude”:”39.1722629″,”longitude”:”-119.748689″}

Please Note: Requires inclusion of availability_radius

availability_radius

Radius around Latitude & Longitude Coordinates in which product is available.

Integer Format: Distance Unit (in km)

Value (example): 9.2

Snapchat Help Documentation

Create a Catalog

Product Catalog Field List