The catalog feed enables Sensefuel to manage all your product information.
We expect to receive all items that are sold and searchable on your website.
- 1 item = 1 SKU = 1 line in CSV/text or 1 item/entry in XML
- Each SKU id must be unique and fully described
Product Variants
If your products have variants (e.g., different sizes or colors):
- Each variant must be sent as a separate SKU (line/item)
- Use the
item_group_idattribute to group variants - Do NOT include the parent product as a line in the feed
Sensefuel specifications are largely based on Google Merchant Center (GMC)
The feed is extensible, meaning:
- You can add custom attributes
- Attribute names must not contain spaces (use underscores instead)
Supported Formats
CSV / Text Format
- Encoding: UTF-8 or Latin1
- Recommended separator:
| - Should use double quotes around all attributes and values
- Multi-valued attributes:
- Allowed for some GMC attributes
- Allowed for all custom attributes
XML Format
- Encoding: UTF-8
- Supported formats:
- RSS 2.0
- RSS 1.0
- Atom 1.0
Best Practices:
- Use
<![CDATA[value]]>to avoid XML parsing conflicts - Do not use empty CDATA
- Multi-values:
- Usually defined by repeating the attribute tag but you can also provide values separated by a coma
List of attributes
| Attribute | Criticality | Sensefuel specification (if different from GMC) or annotations |
| id | Mandatory |
Use the product’s SKU. Must be a unique value for each product. Maximum 50 characters. |
| item_group_id | Optional | Id for a group of products that come in different versions (variants of color, size, etc) and would be mandatory for some websites. This enables Sensefuel to group these variation on a single product tile. |
| product_type | Mandatory | Expected data should represent the nature of the article, its typology, presented as a breadcrumb without the home level and the product detail page level. •Each level must be separated by « space »>« space » •temporary categorization such as « promotions », « sales », « our selection » must not be present in this attribute •Multivalued is only allowed when the feed is in XML format |
| title | Mandatory |
Product title on your website eventually without the brand, size (or gender) as this data should already be in other attributes. No HTML allowed. Maximum 150 characters. |
| brand | Optional |
No HTML allowed Maximum 70 characters. |
| description | Optional |
HTML not recommended and to be avoided. Maximum 5000 characters. |
| link | Mandatory | No relative url allowed, only absolute url are allowed and must match with your website domain. |
| image_link | Mandatory | No relative url allowed, only absolute url are allowed. Image size/weight must be around 50ko |
| availability | Mandatory |
Values allowed : “in stock” "in_stock" and “out of stock” "out_of_stock" out_of_stock products are automatically buried in the ranking |
| price | Mandatory | Numeric data only. Currency must be included (ISO 4217). |
| sale_price | Optional | Numeric data only. Would be mandatory when the product is discounted. Sale_price cannot be higher than the price. Currency must be included (ISO 4217). |
| sale_price_effective_date | Optional |
The date range during which the sale price applies. Use together with the sale_price attribute. Attribute is only useful if you provide a sale_price before their application. If you don’t submit this attribute, the sale_price provided always applies. |
| age_group | Optional | Supported values are : « newborn », « infant », « toddler », « kids » and « adult ». More details here https://support.google.com/merchants/answer/6324463?visit_id=638409963578915778-3343682162&rd=1 |
| gender | Optional | Supported values are : « male », « female » and « unisex ». More details here : https://support.google.com/merchants/answer/6324479?visit_id=638409963578915778-3343682162&rd=1 |
| color | Optional | Would be recommended or mandatory regarding your business context. (especially when the item_group_id is provided) Main colors are recommended to be provided here and if necessary, specify the exact color in a custom attribute. |
| size | Optional | Would be recommended or mandatory regarding your industry or business context. (especially when the item_group_id is provided |
| material | Optional | Main material instead of the product composition. Multivalued allowed |
| pattern | Optional | Use this attribute to describe the pattern or graphic print on your product. Multivalued allowed |
| gtin | Optional | Your product’s Global Trade Item Number. (EAN in Europe / GTIN-13) |
| mpn | Optional | Your product’s Manufacturer Part Number |
| canonical_link | Optional |
Can be mandatory if your product can have multiple URLs on your website. The canonical_link works similarely to the « canonical URL » markup tag and allows you to influence which URLs Google uses for your products in our web search index. https://support.google.com/merchants/answer/9340054?hl=en&sjid=15567907824574762433-AP |
| condition | Optional | The condition of your product at time of sale. Supported values : “new”, “refurbished”, “used” |
| multipack | Optional |
Submit the number of products in your multipack (for example, you're selling 6 bars of soap together). Integer data expected. |
| is_bundle | Optional | Indicates a product is a merchant-defined custom group of different products featuring one main product. Boolean data |
| google_product_category | Optional | Google-defined product category for your product. |
| size_type | Optional | Your apparel product’s cut. Supported values : « regular », « petite », « maternity », « big », « tall », « Plus » |
| adult | Optional | Indicate a product includes sexually suggestive content. Boolean data. |
| scope_id | Optional |
Provide the category id of your product (only useful if you use Sensefuel to build real time hyper-personalized PLP navigation or simply PLP ranking). Multivalued attribute each value must be separated by a coma, without space before or after the coma. Example : catABC,catDEF,catXYZ |
| linked_products | Optional |
Provide linked products of your information system to inherit them dynamically and automatically in your product recommendations of your product detail pages. Multivalued attribute. Each value must be separated by a coma, without space before or after the coma. Example : 233696,586997,452674 |