#Rich Snippets

Rich Snippets (Schema.org tags) are defined the same way for both Pages and Layouts and stored in their schemas: [] field. New Schemas will be added over time. Using supported Schemas allows the user to easily edit them for their purposes, though you can use Custom type as a fallback if the Schema you need to use is not yet supported.

Supported Schemas follow the official specs closely, though sometimes plurals are used rather than singulars, for example images, instead of image or authors instead of author. Some fields also differ slightly for convenience, such as timeRequired always being in minutes.

For specific information about a field, reference the original spec at Schema.org. For example, for what addressCountry accepts, look the field up on Schema.org and find addressCountry.

Almost all fields support Templating, which is of course encouraged since you'll probably want to be pulling data from your Addon or Addon's Collections. Comma-separated fields that require Media IDs will accept arrays of media objects. Numbers are always defined as strings (to allow for Templating).

#Article

This is the officially supported Schema.org Article Schema.

#Breadcrumb List

This is the officially supported Schema.org BreadcrumbList Schema. For simplification, a simple items field is specified as a string instead of having to specify item types, their positions, etc.

#Local Business

This is the officially supported Schema.org LocalBusiness Schema. More subtypes and their specific fields will be added soon.

#Opening Hours

Each opening hours object has the following keys:

If the business is closed, use 00:00 as the open and close time, or leave both blank. If the business is open all day, use 00:00 for opens and 23:59 for closes. For hours after midnight, use the time it closes the next day. For example, a bar that opens Friday at 10:00 PM and closes Saturday at 2:00 AM would use daysOfWeek: 'Friday', opens: '22:00', and closes: '02:00'.

Do not specify validFrom or validThrough if these are the normal business hours.

#Person

This is the officially supported Schema.org Person Schema.

#Product

This is the officially supported Schema.org Product Schema.

#Accomodation Subtype

To set the Product as an Accomodation, set the subtype to "Accommodation". Accomodations have additional fields:

#Reviews

This is the officially supported Schema.org Review Schema. The type should be set as "Reviews", not "Review". Even if you only have one review, it must be listed in the reviews array.

Each review object has the following keys:

#Review Template Example

product.reviews.map(review => {
  return {
    author: review.author,
    dateCreated: review.writtenAt,
    reviewBody: review.content,
    ratingValue: review.rating,
  }
})

#Custom

If the Schema you want to use isn't officially supported by MercuryCMS yet, you can provide your own custom data. This still supports Templating.

For example, you can write this for the body:

{
  '@context': 'https://schema.org',
  '@type': 'Thing',
  name: 'Some Name',
}