Related product [related_product]

Note: This attribute is primarily intended for use in conversational experiences such as AI mode in Google Search.

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
Format
Minimum requirements
Best practices
Examples

When to use

Optional for 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.

Type	Group attribute with 3 sub-attributes
Sub-attributes	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. Accessory `[accessory]`: An accessory to this product, for example a webcam as an accessory to a desktop computer. 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 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]`.
Repeated field	Yes (up to 30)
Schema.org property (What's this?)	No

File format	Example value (for product that has 2 required parts and 1 accessory)
Text (TSV or CSV) data sources	`required_part:id:AZ7A,` `required_part:id:AZ7B,` `accessory:gtin:811571013579`
XML data sources	`<g:related_product>` `<g:relationship_type>required_part</g:relationship_type>` `<g:identifier_type>id</g:identifier_type>` `<g:identifier>AZ7A</g:identifier>` `</g:related_product>` `<g:related_product>` `<g:relationship_type>required_part</g:relationship_type>` `<g:identifier_type>id</g:identifier_type>` `<g:identifier>AZ7B</g:identifier>` `</g:related_product>` `<g:related_product>` `<g:relationship_type>accessory</g:relationship_type>` `<g:identifier_type>gtin</g:identifier_type>` `<g:identifier>811571013579</g:identifier>` `</g:related_product>`
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 3 of 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 characters in 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>…

Was this helpful?

How can we improve it?