>x< Shopping Manager Product specifications guide
>x< Shopping Manager is your single, central one-stop-shop for merchant onboarding and product catalog management tools. Use this guide below to help you properly structure and upload your CSV product catalog file into >x< Shopping Manager. You can manually upload up to a 100 MB file to >x< Shopping Manager or use a Scheduled Feed to automatically send a file that can be up to 8 GB.
These products will be used to create your product sets and set up your shopping presence, including Shop Spotlight, >x< Shops, Live Shopping, and Dynamic Product Ads.
Jump to: Required specs || Optional specs
Required specs
Please ensure that all of the fields below are included in your CSV file when uploading to >x< Shopping Manager.
Product attribute and type | Description |
|---|---|
id Type: string | Max character limit: 100 Unique ID for the item. Use the SKU if possible. If there are multiple instances of the same ID, all instances will be ignored. Example value:
|
title Type: string | Max character limit: 150 The name of the product. Should be the same name as the product from the landing product page given through link or mobile_link attributes. Example value:
|
description Type: string | Max character limit: 5,000 (open-text) The description of the product. This field does not support HTML and must be in plain text. Example value:
|
availability Type: string | Current availability of your item. Select one of the possible values from the list below. Possible values:
|
condition Type: string | Condition of the item being sold. Select one of the possible values from the list below. Possible values:
|
price Type: string | Price of the item. Format the price as a number, followed by the 3-digit ISO currency code (ISO 4217 standards), with a space between cost and currency. Use a period (".") as the decimal point. Example values:
|
link Type: string | URL of the product page specific to the product where people can buy the item. If a user is on a mobile device, and a mobile_link is included, the viewing user will be sent to the URL provided via the mobile_link attribute. We will validate the URL according to RFCs. Specifically it must include “https” or “http”. Example value:
|
image_link Type: string | URL for the primary image of your item. If you change the image later, the new image must use a different URL or the image will not update. Image specifications:
Example value:
|
brand, gtin, and/or mpn Type: string | Only one (1) of brand, gtin, and/or mpn attributes are required, however all are encouraged to include if available. Max character limit for all: 100
Note: This field is highly recommended when uploading product catalogs for Dynamic Product Ads campaigns. |
Optional specs
All of the fields below are optional to include in your CSV file when uploading to >x< Shopping Manager, but in many cases are recommended to provide additional context to your products showcased on >x<.
Product attribute and type | Description |
|---|---|
mobile_link Type: string | URL of a mobile optimized version of the product page specific to the product where people can buy the item. If a user is on a mobile device, the viewing user will be sent to the URL provided via the mobile_link attribute. We will validate the URL according to RFCs. Specifically it must include “https” or “http”. Example value:
|
additional_image_link Type: string | To add more images of your item, use additional_image_link. URLs should be separated by commas. Follow the same specifications as mentioned in the image_link attribute. You can include up to 10 additional images. Example value:
|
google_product_category Type: string | The category of the item, according to Google's product taxonomy. Use the category's taxonomy path or its category ID number. Note that in some cases, this category will be shown to >x< users. Example values:
Note: This field is highly recommended when uploading product catalogs for Dynamic Product Ads campaigns. |
product_type Type: string | The category the item belongs to, according to your business' custom product taxonomy, if you have one. You can also enter a Google product category (google_product_category). Subcategories must be sent separated by " > ". The > must be wrapped by spaces. Note that in some cases, this category will be shown to >x< users. Example value:
|
inventory Type: integer | Must be >= 0 The quantity of this item that you have available to sell on >x<. If included, an item’s inventory value must be 1 or higher when its availability field is set to in stock for the item to be shown to users. Otherwise, this value could be greater than or equal to 0 when its availability field is set to available for order, or preorder for the item to be shown to users. Example value:
Note: This field is highly recommended when uploading product catalogs for Dynamic Product Ads campaigns. |
sale_price Type: string | Must be >= 0 The discounted price of the item. Format the price as a number, followed by the 3-digit ISO currency code (ISO 4217 standards), with a space between cost and currency. Use a period (".") as the decimal point. The sale_price must be lower than the price. If there is no sales price, please leave this optional field blank instead of entering the same value as “price”. Example values:
Note: This field is highly recommended when uploading product catalogs for Dynamic Product Ads campaigns. |
sale_price_effective_date Type: one or two ISO-8601 timestamps | Time range for the item’s sale period, including the date, time, and time zone when your sale starts and ends. If sale dates aren’t entered, any items with a sale_price will remain on sale until you remove their sale price. It is possible to provide just a start date without an end date, in which case the sale price will remain on sale from the start date until the sale price is removed. Format: YYYY-MM-DDT23:59+00:00Z/YYYY-MM-DDT23:59+00:00Z Start date must be before end date. Detailed instructions:
The example below uses the PST time zone (-08:00). Example value:
|
item_group_id Type: string | Max character limit: 100 Use the item_group_id attribute to group product variants together. Variants are a group of similar items that only differ from one another by product details like size, color, age_group, and gender. This field is required if your product has variants. Example value:
Note: This field is highly recommended when uploading product catalogs for Dynamic Product Ads campaigns. |
gender Type: string | Determines gender for item sizing. Select one of the possible values from the list below. Possible values:
Note: This field is highly recommended when uploading product catalogs for Dynamic Product Ads campaigns. |
color Type: string | Max character limit: 100 The primary color of the product. Use one or more words to describe the color. Don’t use the hex code. Example values:
Note: This field is highly recommended when uploading product catalogs for Dynamic Product Ads campaigns. |
size Type: string | Max character limit: 100 Size of the item written as a word, abbreviation, or number. Example values:
|
age_group Type: string | The associated age group of the item. Select one of the possible values from the list below. Possible values:
Note: This field is highly recommended when uploading product catalogs for Dynamic Product Ads campaigns. |
custom_label Type: string | Up to five custom fields (custom_label_0, custom_label_1, custom_label_2, custom_label_3, custom_label_4) for any additional information you want to filter items by when you create filter-based product sets. For example, you could use a custom label field to indicate all products that are part of a summer sale, and then filter those products into a product set. These fields support any string value. Example:
|