Notification

This help center shows articles applicable to Merchant Center Next. Learn more about the upgrade and get answers to frequently asked questions.

Description [description] and structured description [structured_description]

An example ad showing where description text might appear

Use one of the description [description] and structured description [structured_description] attributes to tell customers about your product. List product features, technical specifications, and visual attributes. A detailed description will help us show your product to the right customers.


In this article


When to use

Required Required for each product

For descriptions created using generative AI, use the structured description [structured_description] attribute. Otherwise you can also use the description [description] attribute.

The description [description] attribute is a standard text attribute without sub-attributes.

The structured description [structured_description] attribute uses 2 sub-attributes:

  • Digital source type [digital_source_type] (Optional): Two values are supported:
    • Default [default]: Specifies that the description provided using the content [content] sub-attribute was not created using generative AI.
    • Trained algorithmic media [trained_algorithmic_media]: Specifies that the description provided using the content [content] sub-attribute was created using Generative AI.

If no value is specified, the Default [default] value is used.

  • Content [content] (Required): The description text.

Format

Follow these formatting guidelines to make sure Google understands the data you're submitting.

Learn when and how to submit your product data in English

Type String (Unicode characters, Recommend: ASCII only)
Limits

Description [description]: 1–5,000 characters

Content [content] sub-attribute of structured description [structured_description]: 1–5,000 characters

Repeated field No
Schema.org property
(What's this?)

Description [description]: Product.description, Type: Text

Structured description [structured_description]: Not supported by Schema.org at this time

Description formatting

File format Example value
Text (TSV) Google Chromecast was designed to discreetly connect to your TV. Wirelessly stream and mirror content. Integrated HDMI Connector.
XML (Feeds) <g:description>Google Chromecast was designed to discreetly connect to your TV. Wirelessly stream and mirror content. Integrated HDMI Connector.</g:description>

Structured_description formatting

File format Example value
Text (TSV)

Example created using generative AI:
trained_algorithmic_media:"Transform your TV with the effortless power of Google Chromecast. This sleek device discreetly connects to your television, unlocking a world of wireless streaming and mirroring possibilities. From movies and TV shows to photos and presentations, cast your favorite content directly to the big screen with its integrated HDMI connector."

Example not created using generative AI:
:Google Chromecast was designed to discreetly connect to your TV. Wirelessly stream and mirror content. Integrated HDMI Connector.

Format the value by submitting values for the digital source type [digital_source_type] and content [content] sub-attributes, separated with a colon ( : ).

If a colon is part of the content [content] sub-attribute, surround the entire sub-attribute by double-quotes ("). If a double-quote is part of the content [content] sub-attribute, pair it with a second double-quote. For example, instead of 12" Frying Pan:Teflon, provide "12"" Frying Pan:Teflon".

XML (Feeds) <g:structured_description>
  <g:digital_source_type>
    trained_algorithmic_media
  </g:digital_source_type>
  <g:content>
Transform your TV with the effortless power of Google Chromecast. This sleek device discreetly connects to your television, unlocking a world of wireless streaming and mirroring possibilities. From movies and TV shows to photos and presentations, cast your favorite content directly to the big screen with its integrated HDMI connector.
  </g:content>
</g:structured_description>

To format your data for Content API, go to the Content API for Shopping resource.

Note: To ensure that this product data attribute gets recognized by our system correctly, remember to submit your data source file in a format that we support.

Minimum requirements

These are the requirements you'll need to meet to show your product. If you don't follow these requirements, we'll disapprove your product and let you know in your Merchant Center account.

Note: If your description doesn't fit within the character limit, Google will truncate it to fit. You'll receive a warning indicating that the description has been truncated.
  • Describe only the product itself. Don't describe other aspects like details about compatible products, accessories, or other similar products available. Don't provide your business’s history or policies.
  • Use professional and grammatically correct language. Correct grammar is easier to understand and gives you a more professional appearance, which can lead to more clicks. Also avoid gimmicky ways of drawing attention such as all caps, symbols, and promotional text. Learn more about the editorial & professional requirements.
  • Don’t use words from foreign languages, unless they’re well understood such as a product with a foreign name or title.
    • For example, “sushi” is a word well understood outside of Japan.
    • Write foreign words using the alphabet of your target language. For example, avoid Japanese characters when targeting the United States. Letters with accents, like “Les Clés" are allowed.
    • Don’t use foreign characters for gimmicky purposes. This technique is common in spam and untrustworthy product listings. For example: (ಠ_ಠ)
  • Use XML entities or escaped characters instead of symbols. If you’re submitting your product data in XML or JSON, and you need to include symbols, make sure to follow the XML or JSON specification. For XML, use XML entities such as &quot;. For JSON, use escape characters such as \". If you automatically encode your description, be careful not to encode it twice.
  • Don’t include comparisons or details about other products. For example, "even better than X." Let customers research other products on their own.
  • Don’t include references to categorization systems. For example, don’t include "Toys & Games and then Toys and then Dolls, Playsets & Toy Figures and then Dolls." Include this information using the Google product category [google_product_category] or product type [product_type] attributes.
  • Don’t include links to your store or other websites. Include nothing but a link to your product's landing page with the link [link] attribute.
  • Don’t use capital letters for emphasis. Capitalized text is common in spam and untrustworthy product listing. Use capitalization when it’s appropriate, including for abbreviations, phone numbers, countries, and currency. For example, ADHD, UNICEF, 1-555-CALL-NOW, UK, and USD.
  • Don’t include promotional text such as price, sale price, sale dates, shipping, delivery date, other time-related information, or your company’s name. Include this information with the other attributes such as sale price [sale_price] or shipping [shipping].

  • Submit a description for each product. Products that don’t include a value for the description attribute will receive a warning and may experience limited performance. Similar products that include a description may be prioritized.
  • All descriptions created using generative AI must be provided using the structured description [structured_description] attribute instead of the description [description] attribute. 
    • The digital source type [digital_source_type] sub-attribute of the structured description [structured_description] attribute must have value “trained_algorithmic_media”, indicating that the image was created using generative AI.
    • The content [content] sub-attribute of the structured description [structured_description] attribute must contain the AI-generated description.
  • If you provide both the structured description [structured_description] and description [description] attributes we’ll only use the description [description] attribute.

Best practices

These best practices can help you go beyond the basic requirements to optimize your product data for performance.

  • Be specific and accurate. The more specific you are in your description, the easier it is for customers to identify the product they're searching for.
  • List the most important details in the first 160 - 500 characters. You can include up to 5,000 characters, but customers must click to view product details to see the longer description.
  • Include your product’s most relevant features and visual attributes. Examples of types of information to include:
    • Size
    • Material
    • Intended age range
    • Special features
    • Technical specifications
    • Shape
    • Pattern
    • Texture
    • Design. For example, customers can search for very specific visual terms like “retractable ballpoint pens."
    • Variants. List product defining details like color, size, age group, pattern, flavor, or material.

Additional guidelines

Review each section closely to determine if the requirements apply to your country or product. If you don't follow requirements that apply to you, we'll disapprove your product and let you know in your Merchant Center account.

AI-generated descriptions

For AI generated descriptions use the [structured_description] attribute instead of the description [description] attribute. Provide the AI generated description text in the content [content] sub-attribute and set the digital source type [digital_source_type] sub-attribute to value “trained_algorithmic_media”.
Customized goods
  • Include a description of the product’s customization details. For example, if a product can be engraved with text, add that information to the description.
Merchant-defined bundles and multipacks
  • Describe the entire product bundle or multipack. For example, for a bundle, you might include a description of everything sold together with the main product. For a multipack, you might include information about how many products are sold together.

Examples

Hardware and software

Product data for a Google Chromecast

Attribute

Value

Description [description]

Google Chromecast is a media streaming device that plugs into the HDMI port on your TV. Simply use your mobile device and the TV you already own to cast your favorite TV shows, movies, music, sports, games, and more. Chromecast works with iPhone, iPad, Android, Mac, Windows, and Chromebook.

 

 

Descriptions created using generative AI

Make sure you use the structured description [structured_description] attribute instead of the description [description] attribute for AI-generated descriptions.

Product data for a Google Chromecast

Attribute

Value

Structured description [structured_description] trained_algorithmic_media:"Transform your TV into an endless entertainment hub with Google Chromecast. This compact media streaming device plugs effortlessly into your TV's HDMI port, instantly unlocking a world of content. Control everything from your smartphone, tablet, laptop – whether it's iPhone, iPad, Android, Mac, Windows, or Chromebook. Effortlessly cast your favorite shows, movies, music, sports, games, and so much more straight to the big screen."
 
Books

Product data for the book, "How Google Works"

Attribute

Value

Description [description]

"How Google Works" is an entertaining, page-turning primer containing lessons that Eric and Jonathan learned as they helped build the company. The authors explain how technology has shifted the balance of power from companies to consumers, and that the only way to succeed in this ever-changing landscape is to create superior products and attract a new breed of multifaceted employees whom Eric and Jonathan dub "smart creatives."

 
Products with variants

Product data for pens with red ink

Attribute

Value

Description [description]

These pens feature a generous grip for comfortable writing and a push, retractable ballpoint that provides for easy ink flow. Red ink.

Product data for pens with black ink

Attribute

Description [description]

Value

These pens feature a generous grip for comfortable writing and a push, retractable ballpoint that provides for easy ink flow. Black ink.

Was this helpful?

How can we improve it?
false
Search
Clear search
Close search
Google apps
Main menu
13928487086890357923
true
Search Help Center
true
true
true