Guides
  1. Product Feed
  2. Product Feed Data File

Shopping Feed (Google Format)

Product Feed Specifications: Shopping (Google Format)

The Shopping (Google Format) feed follows the feed specification used by the Google Merchant Center. If you are already submitting a product feed to Google Merchant Center, you should be able to use the same feed in your CJ account with a few modifications.

Your feed should be a plain text or XML document containing only the column names listed below. Column order does not matter, but column names must match exactly. Unlike previous CJ feed formats, the Shopping feed does not include a separate header block with account information.

Field Reference

Use the table below to scan all available fields. Click any row to expand full requirements and error details.

Click any row to see type, format, and value examples.
Parameter
Description
Required
id
Your product's unique identifier. Use SKU where possible.
Required
Type: AlphanumericFormat: Max 50 characters. Allowed special characters: - . # _ /
Examples
SKU-001
PROD_ABC123
Note: Must be unique within the feed. Products with duplicate IDs will be removed on import. Case-sensitive — ABC123 and abc123 are treated as distinct values. If using item-based pixel or batch, the ID must exactly match the SKU passed in your transaction data.
title
Your product's name.
Required
Type: StringFormat: Max 150 characters
Note: Make the name relevant, clear and specific. Include variation details such as color, size, or model — e.g. 'Men's Shirt – Blue – Medium.'
description
Your product's description.
Required
Type: StringFormat: Max 5000 characters
Note: Describe your product's features, specifications, and qualities. The more detail you provide, the more useful it is to publishers and customers.
link
Your product's landing page.
Required
Type: URLFormat: Max 2000 characters. Must be a valid URL including http:// or https://
Note: Links with invalid formatting will be rejected. Products with no valid link will be rejected.
image_link
A link to an image of your product.
Recommended
Type: URLFormat: Max 2000 characters. Must be a valid URL including http:// or https://
Note: Image should accurately depict the product variant. Provide the largest, highest-quality image possible — publishers may resize for various formats. Products with an invalid image link will be accepted without this value.
mobile_link
Your product's mobile-optimized landing page.
No
Type: URLFormat: Max 2000 characters. Must be a valid URL including http:// or https://
Note: Use when you have a different URL for mobile and desktop traffic. Products with an invalid mobile link will be accepted without this value.
additional_image_link
Up to 10 additional product images. Separate multiple values with a comma.
No
Type: URLFormat: Max 2000 characters. Comma separated. Must be valid URLs.
Note: Show your product from different angles or in use. Products with invalid image links will be accepted without this value.
availability
Your product's availability status.
Required
Type: Enum
Allowed Values
in stock
out of stock
preorder
backorder
Note: Marking a product as 'out of stock' does not prevent it from being available to publishers via search or export. Products without a valid availability will be rejected.
availability_date
The date a preordered or backordered item becomes available.
No
Type: DateTimeFormat: ISO 8601 — YYYY-MM-DD, YYYY-MM-DDThh:mm:ss, or YYYY-MM-DDThh:mm:ssZ. Max 25 characters.
Note: Use when availability is 'preorder'. Does not affect when your product is visible to publishers. Products with an invalid availability date will be accepted without this value.
cost_of_goods_sold
The costs associated with the sale of this product (material, labor, freight, overhead).
No
Type: NumericFormat: ISO 4217 format. Use '.' as the decimal separator (e.g. 23.00 USD).
Note: Used to gain insights about gross margin and revenue generated by listings.
expiration_date
The date your product stops being available.
No
Type: DateTimeFormat: ISO 8601 — YYYY-MM-DD, YYYY-MM-DDThh:mm:ss, or YYYY-MM-DDThh:mm:ssZ. Max 25 characters.
Note: Does not affect when your product is visible to publishers. Products with an invalid date will be accepted without this value.
price
Your product's price.
Required
Type: NumericFormat: ISO 4217. Pass amount only (15.00) and the feed-level currency applies, or include the currency code (15.00 USD).
Examples
15.00
15.00 USD
Note: Must not include taxes or shipping. Prices are rounded to 2 decimal places. Any comma in a price is interpreted as a period — 1,500 becomes 1.50. Products with no valid price will be rejected.
sale_price
Your product's discounted/sale price.
No
Type: NumericFormat: ISO 4217. Same formatting rules as price.
Note: Prices are truncated to 2 decimal places. Products with an invalid sale price will be accepted without this value.
sale_price_effective_date
The date range during which the sale price applies.
No
Type: ISO 8601 Date RangeFormat: Max 51 characters. Start and end date separated by slash ( / ).
Examples
2016-02-24T13:00-0800/2016-02-29T15:30-0800
Note: Products with an invalid sale price effective date will be accepted without this value.
unit_pricing_measure
The measure and dimension of your product as it is sold.
No
Type: Numeric + unitFormat: e.g. 1.5kg, 30sqft
Examples
1.5kg
100ml
Note: Supported units — Weight: oz, lb, mg, g, kg. Volume (US): floz, pt, qt, gal. Volume (metric): ml, cl, l, cbm. Length: in, ft, yd, cm, m. Area: sqft, sqm. Per unit: ct.
unit_pricing_base_measure
The product's base measure for pricing.
No
Type: Integer + unit
Examples
100ml
10oz
Note: Optional when you submit unit_pricing_measure. Supported units same as unit_pricing_measure.
installment
Details of an installment payment plan. Brazil and Mexico only.
No
Type: Compound
Note: Uses 2 sub-attributes: months (required, integer — number of installments); amount (optional, ISO 4217 — amount per month). Example: 5:10 MXN (5 months, MXN 10/month).
subscription_cost
Details a monthly or annual payment plan bundled with a communications service contract.
No
Type: Compound
Note: Uses 3 sub-attributes: period (required — 'month' or 'year'); period_length (required, integer — number of periods); amount (required, ISO 4217).
loyalty_points
The number and type of loyalty points a customer receives when buying the product. Japan only.
No
Type: Compound
Note: Uses 3 sub-attributes: points_value (required — number of points); name (optional — loyalty program name, max 12 full-width or 24 roman chars); ratio (optional — conversion ratio to currency).
google_product_category
Google-defined product category for your product.
Recommended
Type: String or IntegerFormat: Use the numerical category ID or the full category path.
Examples
371
Apparel & Accessories > Clothing > Outerwear > Coats & Jackets
Note: Required if you want to view product reporting in Insights. Must be an exact value from the Google product taxonomy. CJ supports categories in: en-US, es-ES, zh-CN, ja-JP, da-DK, de-DE, fr-FR, it-IT, nl-NL, no-NO, pl-PL, pt-BR, sv-SE, tr-TR, cs-CZ, ru-RU.
product_type
Product category that you define for your product.
No
Type: StringFormat: Max 750 alphanumeric characters. Separate multiple values with a comma or slash.
condition
Your product's condition.
Required
Type: Enum
Allowed Values
new
refurbished
used
Note: If condition is 'new', you need either: brand + gtin + identifier_exists='yes', or brand + mpn + identifier_exists='yes', or brand + identifier_exists='no'. If 'refurbished' or 'used', set identifier_exists='no'. Products without a valid condition will be rejected.
brand
Your product's brand or manufacturer name.
Conditional
Type: StringFormat: Max 70 characters. Alphanumeric.
Note: Required if identifier_exists is not 'no'. May repeat up to 10 times. Products with an invalid brand will be accepted without this value.
gtin
Your product's Global Trade Item Number.
Conditional
Type: NumericFormat: 8, 10, 11, 12, 13, or 14 digit code. Separate multiple GTINs with commas or slashes.
Note: Required if condition is 'new' and the product has a manufacturer-assigned GTIN. Accepted formats: UPC (North America, 12 digits), EAN (Europe, 13 digits), JAN (Japan, 8 or 13 digits), ISBN (media, 13 digits), ITF-14 (books, 14 digits). Products without a valid GTIN (who don't have identifier_exists='no') will be rejected.
mpn
Your product's manufacturer part number.
Conditional
Type: AlphanumericFormat: Max 70 characters.
Note: Required if condition is 'new' and the product does not have a manufacturer-assigned GTIN. Not required if GTIN is provided, or if the product has no assigned MPN. Products with no GTIN and no valid MPN will be rejected.
identifier_exists
Indicates whether your new product has unique product identifiers (GTIN, MPN, brand).
Conditional
Type: Enum
Allowed Values
yes
no
(blank — defaults to yes)
Note: Required for products that are missing GTIN and brand, or MPN and brand. If your product doesn't have GTIN+brand or MPN+brand, set to 'no'. Products missing both identifiers without identifier_exists='no' will be rejected.
adult
Indicates a product includes sexually suggestive content.
No
Type: Enum
Allowed Values
yes
no
Note: Blank defaults to 'no'. Do not use for age group — use the age_group field for adult-sized products that are not sexual in nature.
multipack
The number of identical products sold together as a multipack.
No
Type: IntegerFormat: Must be 2 or greater — multipacks cannot contain 1 product.
is_bundle
Indicates a product is a custom group of different products featuring one main product.
No
Type: Enum
Allowed Values
yes
no
energy_efficiency_class
Your product's energy label. EU and CH only.
No
Type: Enum
Allowed Values
G
F
E
D
C
B
A
A+
A++
A+++
min_energy_efficiency_class
The minimum energy efficiency class in your product's energy label range. EU and CH only.
No
max_energy_efficiency_class
The maximum energy efficiency class in your product's energy label range. EU and CH only.
No
age_group
Your product's targeted demographic. Recommended for apparel products.
No
Type: Enum
Allowed Values
newborn
infant
toddler
kids
adult
color
Your product's color(s). Recommended for apparel products.
No
Type: StringFormat: Max 100 characters (max 40 per color). Separate multiple colors with a comma or slash.
Examples
Red/Green/Black
Note: Use common color names (e.g. 'pink' instead of 'flamingo') for better search results. May repeat up to 10 times. Values over 100 characters will be truncated.
gender
Your product's targeted gender. Recommended for apparel products.
No
Type: Enum
Allowed Values
male
female
unisex
material
Your product's fabric or material. Recommended for apparel products.
No
Type: StringFormat: Max 200 alphanumeric characters. Values over 200 characters will be truncated.
Examples
cotton
polyester
pattern
Your product's pattern or graphic print. Recommended for apparel products.
No
Type: StringFormat: Max 100 alphanumeric characters. Values over 100 characters will be truncated.
Examples
plaid
floral
size
Your product's size. Recommended for apparel products.
No
Type: StringFormat: Max 100 alphanumeric characters.
size_type
Your apparel product's cut.
No
Type: Enum
Allowed Values
regular
petite
plus
big and tall
maternity
size_system
The country of the size system your product is sized in.
No
Type: Enum
Allowed Values
US
UK
EU
DE
FR
JP
CN
IT
BR
MEX
AU
item_group_id
Your product's parent-level ID. Use when a product comes in different variants (e.g. same shirt in multiple sizes and colors). Recommended for apparel.
No
Type: AlphanumericFormat: Max 50 characters.
product_length
Your product's length.
No
Type: Number + unitFormat: Supported units: cm, in. Range: 1–3000.
Examples
20 in
50 cm
product_width
Your product's width.
No
Type: Number + unitFormat: Supported units: cm, in. Range: 1–3000.
product_height
Your product's height.
No
Type: Number + unitFormat: Supported units: cm, in. Range: 1–3000.
product_weight
Your product's weight.
No
Type: Number + unitFormat: Supported units: lb, oz, g, kg. Range: 0–2000.
Examples
3.5 lb
product_detail
Technical specifications or additional details of your product.
No
Type: Compound
Note: Uses 3 sub-attributes: section_name (optional, max 140 chars); attribute_name (required, max 140 chars); attribute_value (required, max 1000 chars). Example: General:Product Type:Digital player
product_highlight
The most relevant highlights of your product.
No
Type: List of StringsFormat: Max 150 characters.
ads_redirect
A URL used to specify additional parameters for your product page. Customers are sent to this URL instead of the link or mobile_link.
No
Type: URLFormat: Max 2000 characters.
custom_label_0–4
Custom fields for data that doesn't fit in another field.
No
Type: StringFormat: Max 100 characters per label (custom_label_0 through custom_label_4).
Note: Products with invalid custom field values will be accepted without those values.
shipping
Your product's shipping cost.
No
Type: Compound
Note: Uses up to 9 sub-attributes: country (required, ISO 3166), region (optional), postal_code (optional), location_id (optional), location_group_name (optional), service (optional), price (optional, include currency code or feed default applies), min_handling_time/max_handling_time (optional), min_transit_time/max_transit_time (optional). For delimited files, indicate sub-attributes in the header with colon separators. Example header: shipping(country:postal_code:service:price). Example value: US:93103:flat rate ground:5 USD
shipping_weight
The weight of the product used to calculate shipping costs.
No
Type: Integer + unitFormat: Supported units: lb, oz, g, kg. Imperial: 1–2000 lbs. Metric: 1–1000 kg.
shipping_length / shipping_width / shipping_height
The dimensions of the product used to calculate shipping costs by dimensional weight.
No
Type: Integer + unitFormat: Value: 1–1000. Supported units: in, cm.
ships_from_country
The country from which your product will typically ship.
No
Type: StringFormat: 2-character ISO 3166-1 alpha-2 country code.
Examples
US
GB
min_handling_time / max_handling_time
The shortest and longest number of days between when an order is placed and when the product ships.
No
Type: IntegerFormat: Must be greater than 1.
transit_time_label
Label assigned to a product to help assign different transit times in Merchant Center account settings.
No
Type: StringFormat: Max 100 characters.
tax
Your product's sales tax rate in percent.
No
Type: Compound
Note: Uses 4 sub-attributes: rate (required, percentage without % sign e.g. 8.75), country (optional, ISO 3166), region/postal_code/location_id (optional), tax_ship (optional, yes or no). For delimited files: tax(rate:country:tax_ship:postal_code) / 8.75:US:no:93103
certification
Certifications required by local regulations (e.g. EU energy efficiency ratings).
Conditional
Type: Compound
Note: Required for certain classes of electronics sold in certain European countries. Uses 4 sub-attributes: certification_authority (required), certification_name (required), certification_code (conditionally required — required for EU EPREL energy labels), certification_value (conditionally required). At any given time, only one of certification_code or certification_value should be present. Example: certification(certification_authority:certification_name:certification_code) / EC:EPREL:123456
shipping_label | adwords_redirect | promotion_id | included_destination | excluded_destination | tax_category
AdWords/Google Merchant Center management fields. CJ will accept a feed with these fields but will not store them or display them to publishers.
No

Languages

The CJ Shopping (Google Format) feed is supported in the following languages. Use the Content Language field in the feed setup to indicate the language of the content in your feed. For example, if your product descriptions are written in French, set your feed language to French.

Language
Chinese (Simplified)
Chinese (Traditional)
Czech
Danish
Dutch
English (GB)
English (US)
French
German
Indonesian
Italian
Japanese
Norwegian
Polish
Portuguese (Brazil)
Russian
Spanish
Spanish (Latin America)
Swedish
Ukrainian
📘

The CJ Travel and Experiences feed is only supported in English. All header values and enumerated values must be in English. Product names and descriptions may be in any language.

You may pass header values and enumerated field values in your feed in any of the supported languages. Fields with enumerated values include:

  • Availability
  • Unit pricing measure
  • Google product category
  • Identifier exists
  • Condition
  • Adult
  • Is bundle
  • Age group
  • Shipping
  • Shipping label
  • Shipping weight, length, width and height
  • Tax

Regardless of the language you import in, all enumerated values will be displayed and exported to publishers in English. This ensures consistency for publishers subscribed to multiple advertiser feeds.

Updated 11 days ago