Data Attributes
The following attributes are required for the correct and complete functioning of the tools. They are used to check if the recommended size is available and to make recommendations if unavailable.
As we recommend the use of the Google Shopping Feed, the requirements listed below are closely related to it, and a link to the relevant website is provided in square brackets. For a detailed example, including all mandatory and optional data fields, click here.
- TITLE
- GTIN
- VARIANT ID
- MPN
- LINK
- IMAGE LINK
- PRICE
- SALE PRICE
- AVAILABILITY
- BRAND
- PRODUCT TYPE
- ITEM SUBGROUP ID
- SIZE
- GENDER
- AGE GROUP
1. TITLE [title]
Use the title attribute to clearly identify the product you are selling.
1.1 WHEN TO USE
Required for each product
1.2 FORMAT
| Type | String (Unicode characters; recommended: ASCII only) |
|---|---|
| Limits | 1 - 150 characters |
| Examples | FOCUS Atlas 6.7 grey Cube Aim Race olive/black |
2. GTIN [gtin]
Use the GTIN (Global ID) attribute to specify Global Trade Item Numbers (GTINs). A GTIN helps us to uniquely identify your product.
2.1 WHEN TO USE
Required for all products with a GTIN assigned by the manufacturer. If no GTIN is available, the MPN attribute is used.
2.2 FORMAT
| Type | String (Unicode characters; recommended: ASCII only) |
|---|---|
| Limits | 0 - 14 characters |
| Examples | 4000990402378 4054571385611 |
3. VARIANT ID
Use the VARIANT ID attribute to specify the variant. The VARIANT ID helps us to identify the product or to select the recommended variant.
3.1 WHEN TO USE
Required for all products. Since this attribute is usually autogenerated by your shop system it's available for every product.
3.2 FORMAT
| Type | String (Unicode characters; recommended: ASCII only) |
|---|---|
| Limits | 1 - 70 characters |
| Examples | 50668115656978 50668115722514 |
4. MPN [mpn]
Use the MPN attribute to submit your product’s Manufacturer Part Number (MPN). MPNs are used to uniquely identify a specific product among all products from the same manufacturer.
4.1 WHEN TO USE
Required for all products without a manufacturer assigned GTIN.
4.2 FORMAT
| Type | String (Unicode characters; recommended: ASCII only) |
|---|---|
| Limits | 0 - 70 characters |
| Examples | B0237OS1 402590-SPO-CS-983-SF |
5. LINK [link]
When users click on your product, they are sent to a landing page on your website for that product. Set the URL for this landing page with the link attribute.
5.1 WHEN TO USE
Required for each product.
5.2 MINIMUM REQUIREMENTS
- The link must be a complete URL that includes the scheme and domain.
- Incorrect - /my-product-online/12345.html
- Correct - https://www.onlinesizing.bike/en/products/
- The link must point to the product detail page, not to a product listing page or a placeholder page or a page that has not yet been published.
- The URL must point to the production website, not a staging website.
5.3 FORMAT
| Type | String (Unicode characters; recommended: ASCII only) |
|---|---|
| Limits | 1 - 2000 characters |
| Examples | https://www.onlinesizing.bike/en/products/ |
6. IMAGE LINK [image_link]
Include the URL for your main product image with the image link attribute.
6.1 WHEN TO USE
Required for each product.
6.2 MINIMUM REQUIREMENTS
- The image must be representative of the product, not a placeholder image or logo.
- The image must be specific to an item subgroup, and it must be the same for all sizes.
- The link must be a complete URL that includes the scheme and domain.
- Incorrect - /my-product-online/12345.html
- Correct - https://www.onlinesizing.bike/images/scott-scale-910.jpg
- The link must point to an image on a published production website.
6.3 FORMAT
| Type | String (Unicode characters; recommended: ASCII only) |
|---|---|
| Limits | 1 - 2000 characters |
| Examples | https://www.onlinesizing.bike/images/scott-scale-910.jpg |
7. PRICE [price]
Use the price attribute to tell users how much you’re charging for your product. This information is shown to users.
7.1 WHEN TO USE
Required for each product.
7.2 FORMAT
| Type | Number |
|---|---|
| Examples | 1699.00 679 |
8. SALE PRICE [sale_price]
Use the sale price attribute to tell customers how much you charge for your product during a sale. During a sale, your sale price is shown as the current price.
8.1 WHEN TO USE
Optional for each product.
8.2 FORMAT
| Type | Number |
|---|---|
| Examples | 1659.00 649 |
9. AVAILABILITY [availability]
Use the availability attribute to provide information about whether you have a product in stock.
9.1 WHEN TO USE
Required for all products.
9.2 FORMAT
| Type | Text |
|---|---|
| Supported values | in_stock out_of_stock preorder backorder |
10. BRAND [brand]
Use the brand attribute to indicate the brand name of the product so we can customize the recommendations to that brand.
10.1 WHEN TO USE
Required for each product.
10.2 MINIMUM REQUIREMENTS
- Brand names must not include the factory name or the holding company.
10.3 FORMAT
| Type | String (Unicode characters; recommended: ASCII only) |
|---|---|
| Limits | 1 - 70 characters |
| Examples | Focus Cube Scott |
11. PRODUCT TYPE [product_type]
Use the product type attribute to include your own product categorization system in your product data.
11.1 WHEN TO USE
Required for each product.
11.2 FORMAT
| Type | String (Unicode characters; recommended: ASCII only) |
|---|---|
| Limits | 1 - 750 characters |
| Examples | Gravel Bikes Hardtails 29” |
12. ITEM SUBGROUP ID [item_subgroup_id]
Use the item subgroup ID attribute to group together all sizes for a specific product variant. The different variants are distinguished by the combination of color, material, features, etc.
12.1 WHEN TO USE
Required for each product.
12.2 MINIMUM REQUIREMENTS
- The item subgroup ID must be current and historically unique in your store.
- The item subgroup ID must be the same for all locations.
- Matching item subgroup IDs must be available on product detail pages and order confirmation pages on your website and mobile apps.
12.3 FORMAT
| Type | String (Unicode characters; recommended: ASCII only) | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Limits | 1 - 70 characters | ||||||||||||
| Examples |
|
13. SIZE [size]
Use the size attribute to describe the standardized size of your product.
13.1 WHEN TO USE
Required for each product.
13.2 MINIMUM REQUIREMENTS
- The product feed must include all sizes in which the product is manufactured, including sizes that are not in stock. Current stock availability information is collected in the availability attribute.
13.3 FORMAT
| Type | String (Unicode characters; recommended: ASCII only) |
|---|---|
| Limits | 1 - 100 characters |
| Examples | S, M, L 45cm, 48cm, 50cm Children: 14" |
14. GENDER [gender]
Specify the gender your product is designed for using the gender attribute. Gender allows us to customize the user experience and personalize our size recommendations.
14.1 WHEN TO USE
Required for each product.
14.2 MINIMUM REQUIREMENTS
- If the product is designed to be used by all genders, the value must be unisex, not empty or undefined.
14.3 FORMAT
| Type | Text |
|---|---|
| Supported values | male female unisex |
15 AGE GROUP [age_group]
Use the age group attribute to set the demographic that your product is designed for. Distinguishing between adult and children's products is critical to making meaningful sizing recommendations.
15.1 WHEN TO USE
Required for each product.
15.2 FORMAT
| Type | Text |
|---|---|
| Supported values | adult child |