Supported fields

As of July 2025, the Sales Layer Google Shopping Connector supports all attributes defined in Google’s Product Data Specification. For a full reference of each XML field (including its tag name, data type, repeatability, and subfield structure), refer to Google’s Product Data Specification.

Google requires certain attributes for all products, while others are conditionally required based on the country, product category, or listing type (e.g. free listings vs Shopping Ads).

 

Universally Required Attributes

Fields always required, regardless of country, product type, or program:

  • id: Unique product ID
  • title: Product name
  • description: Detailed product description
  • link: Product landing page URL
  • image_link: Main product image URL
  • price: Product price (including currency)
  • availability: Availability status (e.g. in_stock, out_of_stock)

 

Conditionally Required Attributes

Fields required in specific scenarios, such as when targeting particular countries or product categories:

  • brand: Required for all new, mass-manufactured products except books, movies, and music
  • gtin: Required if the product has a valid GTIN (e.g. UPC, EAN, JAN, ISBN)
  • mpn: Required if there is no GTIN
  • condition: Product condition (e.g. new, used, refurbished)
  • availability_date: Required for products in preorder or backorder
  • adult: Required for adult content
  • multipack: Required in some countries if the product is a multipack
  • is_bundle: Required for bundles in supported countries
  • age_group, color, gender, material, pattern, size, item_group_id: Required for apparel & accessories and variant products, depending on country and category
  • shipping: Required in countries where shipping costs must be explicitly declared
  • external_seller_id: Required for multi-seller accounts
  • certification: Required for regulated products (e.g. energy labeling in the EU)

Note: Please consult Google’s documentation for up-to-date requirements per country and product category.

Important: If a required attribute is missing or incorrect, the product may be disapproved and will not appear in Shopping results.

Requirements
Initial configuration