Use the related product [related_product]
attribute to indicate other products in your inventory that are related to this product, such as accessories, spare parts, or substitutes.
On this page
When to use
Optionalfor each product.
This attribute will be used in conversational AI experiences, for example to suggest other products that a user can purchase together with, or instead of, this product.
The related product [related_product]
attribute can be used in all countries.
Format
Follow these formatting guidelines to make sure Google understands the data you're submitting. Learn more about how to submit attributes and attribute values .
- Relationship type
[relationship_type](required): String. The following enumeration values are supported:- Part of set
[part_of_set]:Another product that is part of the same series/product line, for example: a chair belonging to a table. - Required part
[required_part]:Part that is necessary for the product to function, for example a battery for a battery-operated lamp. - Often bought with
[often_bought_with]:A product that this product is often purchased together with, for example a phone case with a phone. - Substitute
[substitute]: Product that this product can be substituted for, for example a printer comparable in function to another printer. - Different brand
[different_brand]:An identical product sold under a different brand, for example a cheaper house brand. - A ccessory
[accessory]: An accessory to this product, for example a webcam as an accessory to a desktop computer.
- Part of set
- Identifier type
[identifier_type].(required): String. The type of product identification identifier that is provided. This sub-attribute supports the following values:- GTIN
[gtin]: The identifier is a GTIN (or UPC, EAN, JAN, ISBN). - ID
[id]:The identifier is a product ID in your data source
- GTIN
- Identifier
[identifier](required):String. This sub-attribute specifies the actual identifier value of the other product that is related to this product. The identifier value should match the type specified in identifier type[identifier_type].
| File format | Example value (for product that has 2 required parts and 1 accessory) |
| Text (TSV or CSV) data sources | |
| XML data sources | |
| API data sources |
To format your data in the Merchant API, check the Merchant API resource. |
Minimum requirements
These are the requirements you'll need to meet to provide valid related products for your product:
- Submit all 3of the relationship_type
[relationship_type], identifier type[identifier_type], and identifier[identifier]sub-attributes. - If a relationship type
[relationship_type]has multiple applicable related products,provide a separate related product[related_product]attribute for each of these related products. Don't comma-separate the identifiers as part of the identifier[identifier]sub-attribute. - Don't use special charactersin the identifier
[identifier]sub-attribute. Only use alphanumeric, underscores, and dashes. Don't use commas, colons, double quotes, or backslashes.
Best practices
- A product can have multiple relationship types with other products, for example, it can have one or more substitutes, one or more accessories, and one or more required parts. Provide all of these relationship types and their related products with that relationship type.
Examples
A camera with 2 required parts (for example, a battery and a lens) and one accessory (for example, a carrying case) sold separately
In a Google Sheet, you’d submit this in one cell as follows:
| N | O |
P | |
|---|---|---|---|
|
1
|
... | related_product | ... |
|
2
|
... | required_part:id:AZ7A,required_part:id:AZ7B,accessory:gtin:811571013579
|
... |
|
3
|
... | ... | ... |
Alternatively, you can also create multiple separate columns, each containing a single FAQ. For example, to have one column for each value, you can submit this in 3 cells as follows:
| N | O | P | Q | R | |
|---|---|---|---|---|---|
|
1
|
... | related_product | related_product | related_product | ... |
|
2
|
... | required_part:id:AZ7A
|
required_part:id:AZ7B
|
accessory:gtin:811571013579
|
... |
|
3
|
... | ... | ... | ... | ... |
In a tab-separated text file you can submit the FAQs in one cell as follows. Tab characters are represented by the <tab> symbol. Each sub-attribute value has been quoted for consistency:
Header: … <tab> related_product <tab> …
product row: … <tab> required_part:id:AZ7A,required_part:id:AZ7B,accessory:gtin:811571013579 <tab> …
Alternatively, you can also create multiple separate columns, each containing one FAQ. For example, to have one column for each section, you can submit this in 3 tab-separated values as follows:
Header: … <tab> related_product <tab> related_product <tab> related_product <tab> …
Product row: … <tab> required_part:id:AZ7A <tab> required_part:id:AZ7B <tab> accessory:gtin:811571013579 <tab> …
