MicroData (Structured Data, Schema.org)

What is MicroData

MicroData, also known as Structured Data or Schema.org tagging is a standard by which the HTML store and product data is tagged for use by search engines.

👍

Product MicroData tagging is done automatically by Zoey

Your Products & Categories are tagged automatically so there is no need to copy/paste or edit code to get the below structured data to be present in your HTML.

Product Page

Zoey's Product Pages automatically apply the below Schema.org Structured Data tags in your page's HTML.

Tag

Value

@type

Product

url

https://yourdomain.com/urlkey

sku

Product SKU

name

Product Name

itemCondition

Text value from the "item_condition" custom attribute

image

Each image (main and gallery) will be tagged as Image with the CDN URL

disambiguatingDescription

This Overview (or short_description) of the product.

description

The description of the product (whether added to the page or not)

productID

product SKU (repeated)

brand
↳@type
↳name

  • ↳thing
    ↳Value from "brand" custom attribute

offers
↳@type

"Price"

↳ @id

This is the URL of the "Div" in the HTML where the price tagging can be found.

↳ availability

In Stock or Out Of Stock - Note: Web Settings >Product Settings > Load product availability in page source Must be set to YES, otherwise you will receive a Warning from Google Structured Data Testing Tool.

↳ price

The lowest initially listed sale price. So if a product is $50, but on sale for $40, the value for Price in the structured data will be $40.

↳ priceCurrency

Currency

priceValidUntil

Not Currently Supported
You may see this as a Warning in the Google Structured Data Testing Tool. The warning can be ignored.

offerCount

Not Currently Supported
You may see this as a Warning in the Google Structured Data Testing Tool. The warning can be ignored.

aggregateRating
↳ @type

"AggregateRating"

↳ ratingValue

1 - 5 (5 being highest)

↳ ratingCount

Total number of ratings/reviews

Item Condition Tag

The itemCondition tag is only visible on your product page if you fill in a value for item_condition on your products. This can be done via CSV with the column header item_condition, or in the Custom Attributes section of your product edit screen.

Note: itemCondition is not required but is helpful for Google Merchant Approval.

Adding itemCondition tag to ProductsAdding itemCondition tag to Products

Adding itemCondition tag to Products

Brand Tag

The brand tag is only visible on your product page if you fill in a value for brand on your products. This can be done via CSV with the column header brand, or in the Custom Attributes section of your product edit screen.

If you do not have an attribute called "brand", you can create one in Products > Attributes.

Product Page Warnings

This Product is missing a global identifier (e.g. isbn, mpn or gtin8). Please see documentation for valid identifiers.
We do not currently support tagging for other identifiers aside from SKU. It is not required and can be ignored.

url
This is typically a False-Positive warning due to other unsupported or incomplete tagging such as missing aggregateRatings etc... You should have at least 1 url tag at the top of the structured data right below @type = Product

Other Warnings
Anytime you see a warning for Image, or Description, that means the product doesn't have an Image or Description.

Category Pages

Zoey strictly follows Google's guidelines for category or item list pages (see below)

🚧

A category page listing several different products (or recipes, videos, or any other type). Each entity should be marked up using the relevant schema.org type, such as schema.org/Product for product category pages. Marking up just one category entity from all listed on the page is against our guidelines.

Reference: https://developers.google.com/search/docs/guides/intro-structured-data#multiple-entities-on-the-same-page

Zoey tags each individual product that appears on your category page.

The properties tagged for each product are below:

Tag

Value

@type

Product

url

https://yourdomain.com/urlkey

sku

Product SKU

name

Product Name

offers
↳@type

"Price"

↳ @id

For-Sale Price of the product

↳ availability

In Stock or Out Of Stock

↳ price

Base brice of the product

↳ priceCurrency

Currency

aggregateRating
↳ @type

"AggregateRating"

↳ ratingValue

1 - 5 (5 being highest)

↳ ratingCount

Total number of ratings/reviews

Category Page Warnings

The above warning are perfectly normal for category pages as the Google Structured Data testing tool does not know that you are testing a category page.

  • priceValidUntil - This is not a tag we support.
  • url - as mentioned in Product Page Warnings, this is a false-positive warning and can be ignored.
  • aggregateRating - This error will appear if you do not have ratings on an item or if Product Rating is not enabled in Zoey.
  • brand & description - We do not load this data on category pages as it is not needed. Even if we did load the description, other google rules would penalize us for not showing the content on the page. A list of products does not show the full description of the product.
  • image - We don't load the image as there is no benefit to it being on category scheme. The only thing beneficial is the product itself, the price and the rating as those are used by google for category page SERPS.
  • review - Only aggregate rating is used by google for category pages, there is no benefit to loading review data on a category page. And like with description, google would penalize your page if you only loaded the data into the markup and didn't display it to the customer.

Homepage/Information Pages

Your homepage and information pages will only contain structured data if Product Lists blocks are loaded on them. You can always add your own structured data by using the Asset Manager, or an HTML block.

Testing your Structured Data

If you would like to test that your structured data is coming through, you can copy/paste the store-front URL from any of your product or category pages into Google's structured data testing tool.

Contact Zoey Support if you have any questions.