Shopify Product Feed

product.variant.id

No / Auto

id

Required

Advertiser’s unique product ID used to identify each product.

• Format: Alphanumeric, underscores and dashes.

• Length: 1-50 characters.

• Example:

  {"id":"16817108"}

  JSON

product.title and product.variant.title

Yes

title

Required

Advertiser’s product name. Distinguish between variants where applicable.

• Format: Unicode characters (Recommended: ASCII-only).

• Length: 1-150 characters.

• Example:

  {"title":"Organic Cotton Men's T-Shirt - Blue - M"}

product.description

No

description

Required

 Advertiser’s product description.

• Format: Unicode characters (Recommended: ASCII-only).

• Length: 1-5,000 characters.

• Example:

  {"description":"Made from 100% organic cotton, this classic red men's polo..."}

product.handle

Auto

link

Required

Direct link to the product, non-trackable.

• Format: URL (RFC 3986 compliant, ASCII characters only).

• Length: 1-2,000 characters.

• Example:

  {"link":"https://www.example.com/writing/pens"}

product.variant.image.url or product(media….)image.url

No

image_link

Required

Direct link to the product image, non-trackable.

• Format: URL (JPEG, WebP, PNG, GIF, BMP, or TIFF).

• Length: 1-2,000 characters.

• Example:

  {"image_link":"http://www.example.com/image1.jpg"}}

product.category.(fullName/id)

No

google_product_category

Recommended

Google-defined product category.

• Format: Numerical ID or category path.

• Example:

  {"google_product_category":"Apparel & Accessories > Clothing > Dresses"}

product.variant.inventoryQuantity

No

availability

Required

Indicate product availability.

• Values: in_stock, out_of_stock, preorder, backorder.

• Example:

  {"availability":"in_stock"}

product.variant.price

Yes

price

Required

Product price.

• Format: Number plus currency (ISO 4217).

• Example:

  {"price":"15.00 GBP"}

product.vendor

Yes

brand

Required

Name of the product's brand. Required along with MPN for all products not having GTIN.

• Format: Unicode characters (Recommended: ASCII only)

• Length: 1–70 characters

• Example:

  {"brand":"Google"}

product.variant.barcode

No

gtin

Required*

Global Trade Item Number (GTIN), a unique and internationally recognised identifier for a product.

Number (spaces and dashes are accepted, but ignored)

• 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

Example:

{"gtin":"3243567980126"}

product.variant.sku

No

mpn

Required*

Product's Manufacturer Part Number (MPN), a unique number issued by manufacturers to identify individual products

• Format: String (Alphanumeric, Unicode characters. Recommended: ASCII only)

• Length: 1–70 characters

• Example:

  {"mpn":"EXA12345MPLE"}

If the product doesn’t have a clearly associated MPN or is a custom-made product (for example, art, custom t-shirts, novelty products, and handmade products), the attribute is optional.

product.id

No

item_group_id

Required*

The product’s group ID. If the product is one variation of a set of products (e.g. the same shoes in multiple sizes and colours), use this attribute for the ID/SKU of the product. Publishers will be able to group variations of the same product that way.

• Format: String (Alphanumeric, Unicode characters. Recommended: ASCII

• Length: 1–50 characters

• Example:

  {"item_group_id":"AB12345"}

• When you submit an item group ID, make sure that your variants use at least one of the variant attributes: ‘color’, ‘pattern’, ‘material’, ‘age_group’, ‘gender', ‘size’

• Use the ‘id’ attribute to uniquely identify a single product, and use item_group_id to group together several products as variants.

• Don't submit a parent SKU as a separate product. If you'd like to group variants using a parent SKU, use the parent SKU as the value for the item_group_ID attribute for all products in the variant group.

• Don’t submit a value for the item group ID attribute if your product is not a variant. If your product is similar to other products, but not specifically a variant, don’t t submit the item group ID attribute.

Google requires this for free listings for product variants

Google also requires this for Shopping ads for product variants targeting the following countries:

• Brazil

• France

• Germany

• Japan

• United Kingdom

• United States

Optional otherwise

“new”

N/A

condition

Required

Condition of the product
Supported values must be submitted in English:

• new

• refurbished

• used

  Example:

  {"condition":"new"}