The rich product content [rich_product_content]
attribute allows you to compose rich descriptions that combine text and media. Rich content allows you to highlight special features of products or services. Rich content can be provided using different encodings, including JSON-LD, RDFa, and microdata.
We recommend that you use the Google structured data testing tool to test your rich content and check that it doesn’t contain errors. All the examples given in this article can be tried out in the testing tool.
This article describes the data structures necessary for different rich content.
[rich_product_content]
attribute. Learn how to get started with Manufacturer Center APIHow it works
Rich content
Rich content consists of a sequence of showcase blocks. Each block is either a showcase feature set or a media gallery. Blocks are rendered vertically in a single column. Rich content is specified with an element of type Showcase.
Type Showcase extends CollectionPage |
||
Property | Expected type | Description |
showcaseBlock |
ShowcaseFeatureSet or MediaGallery |
A block of rich content. The block must either be a showcase feature set or a media gallery. |
Showcase feature set
A showcase feature set consists of an optional headline and a sequence of showcase features. Feature sets can be rendered in a single or multiple column display.
Type ShowcaseFeatureSet extends ItemList |
||
Property | Expected type | Description |
layoutHint |
Text |
An optional hint indicating how many columns to use for rendering. The features are rendered first in rows and then in columns. The following values are supported:
The layout hint is enforced on a best-effort basis. On small screens, fewer columns than requested may be used. |
headline |
Text |
An optional headline describing the feature set. |
itemListElement |
ShowcaseFeature |
A showcase feature of the set. Features are first rendered in rows and then in columns. |
Showcase feature
A showcase feature consists of a headline, a description, and an optional image.
Type ShowcaseFeature extends ListItem |
||
Property | Expected Type | Description |
layoutHint |
Text |
An optional hint indicating where to render the image relative to the headline and the description. The following values are supported:
|
headline |
Text |
The headline of the feature. |
description |
Text |
The description of the feature. |
image |
URL or ImageObject |
An optional image illustrating the feature |
Media gallery
A media gallery consists of an optional headline and a sequence of images. The images are rendered in one or multiple columns.
Type MediaGallery extends CollectionPage |
||
Property | Expected Type | Description |
layoutHint |
Text |
An optional hint indicating how many columns to use for rendering. The images are rendered first in rows and then in columns. The following values are supported:
|
headline |
Text |
An optional headline to display at the top of the gallery. |
image |
URL or ImageObject |
The image to display in the gallery. |
Note on namespaces
The types Showcase
, ShowcaseFeatureSet
, ShowcaseFeature
, and MediaGallery
and the properties showcaseBlock
and layoutHint
are schema extensions defined under http://schema.googleapis.com/. All the other types and properties are defined under http://schema.org/.
Examples
Empty rich content format
Empty rich content | |
JSON-LD | |
|
|
RDFa | |
<div vocab="http://schema.org/" prefix="g: http://schema.googleapis.com/"> |
|
Microdata | |
<div itemscope itemtype="http://schema.googleapis.com/Showcase"> |
Single showcase feature with headline and description, and no image
A single showcase feature with
|
|
JSON-LD | |
>{ |
|
RDFa | |
<div vocab="http://schema.org/" prefix="g: http://schema.googleapis.com/" typeof="g:Showcase"> |
|
Microdata | |
><div itemscope itemtype="http://schema.googleapis.com/Showcase"> |
Single showcase feature with headline, description, and image
A single showcase feature with
|
|
JSON-LD | |
>{ |
|
RDFa | |
><div vocab="http://schema.org/" prefix="g: http://schema.googleapis.com/" typeof="g:Showcase"> |
|
Microdata | |
><div itemscope itemtype="http://schema.googleapis.com/Showcase"> |
Single showcase feature with headline, description, and image using layout hints
A single showcase feature with
|
|
JSON-LD | |
>{ |
|
RDFa | |
><div vocab="http://schema.org/" prefix="g: http://schema.googleapis.com/" typeof="g:Showcase"> |
|
Microdata | |
><div itemscope itemtype="http://schema.googleapis.com/Showcase"> |
Showcase feature set using layout hints to change layout
A single showcase feature set
|
|
JSON-LD | |
>{ |
|
RDFa | |
><div vocab="http://schema.org/" prefix="g: http://schema.googleapis.com/" typeof="g:Showcase"> |
|
Microdata | |
<div itemscope itemtype="http://schema.googleapis.com/Showcase"> |
Media gallery: single banner image
A media gallery
|
|
JSON-LD | |
{ |
|
RDFa | |
<div vocab="http://schema.org/" prefix="g: http://schema.googleapis.com/" typeof="g:Showcase"> |
|
Microdata | |
><div itemscope itemtype="http://schema.googleapis.com/Showcase"> |
Three showcase blocks: single feature, showcase feature set, single banner image
Three showcase blocks
|
|
JSON-LD | |
{ |
|
RDFa | |
<div vocab="http://schema.org/" prefix="g: http://schema.googleapis.com/" typeof="g:Showcase"> |
|
Microdata | |
<div itemscope itemtype="http://schema.googleapis.com/Showcase"> |