Structured Data Markup

This topic applies to

Applies to

SuiteCommerce | SuiteCommerce Advanced

 

SuiteCommerce and SuiteCommerce Advanced 2020.1 and later support JSON-LD structured data markup. Major search engines use structured data markup to discover detailed information about a page and enhance search results.

SuiteCommerce web stores use JavaScript Object Notation for Linked Data (JSON-LD) when implementing structured data markup. The JSON-LD markup is located within script tags in the HTML head section of product detail pages. Product list pages do not include the JSON-LD markup.

See schema.org/product for additional product-related schema information.

Setup

To use structured data markup for your domain, you must configure two options in the domain configuration record. After saving the changes for your domain, SuiteCommerce web sites automatically incorporate valid JSON-LD structured data markup into each of the product detail pages on the site. See JSON-LD Product Schema Properties for an alphabetical list of properties used in the structured data markup.

Enable Structured Data Markup

  1. In NetSuite, go to Setup > SuiteCommerce Advanced > Configuration.

  2. Select your website and domain and click Configure.

  3. In the Configuration record, navigate to the Shopping Catalog tab and the Structured Data Markup subtab.

  4. Select JSON-LD in the Markup Type field.

  5. Select an Out of Stock Behavior. These options only apply when back orders are allowed.

    Options include:

    • InStock. Select this option when back orders are allowed and availability property markup will be set to: http://schema.org/InStock. InStock is the default value.

    • PreOrder. Select this option when back orders are allowed and availability property markup will be set to; http://schema.org/PreOrder.

  6. Click Save.

JSON-LD Product Schema Properties

SuiteCommerce and SuiteCommerce Advanced use the properties listed below to describe product content.

Property

Content

aggregateRating

Overall rating, based on a collection of reviews or ratings, of the item. For additional information about each associated subfield, see AggregateRating.

availability

Availability of the item when back orders are allowed. Options include InStock or PreOrder. InStock is the default.

description

Description of the item.

image

Location URL of an image of the item. See ImageObject.

name

Name of the item.

offers

Details about the item offered for sale.

price

Offer price of the item.

priceCurrency

Currency code used for the price. See ISO 4217 for a list of valid currency codes.

ratingValue

Dontent rating.

review

Review of the item.

reviewCount

Total number of reviews.

sku

Merchant-specific identifier for the item.

url

URL of the item.

A sample of JSON-LD markup is shown below.

<script type="application/ld+json"> { "@context": "https://schema.org", "@type": "Product", "name": "Yamaha 2017 BB735A Electric Guitar - Dark", "aggregateRating": { "@type": "AggregateRating", "ratingValue": "5", "reviewCount": "1" } "description": "The Yamaha 2017 BB735A Electric Guitar is a superior guitar.", "url": "https://search.google.com/Yamaha-2017-BB735A-Electric-Guitar-Dark?quantity=1", "image": "http://test.commerceapplication.com/Images/yamaha_2017_bb735a.00.jpg?resiseid=31&resizeh=600&resizew=600", "sku":"Yamaha 2017 BB735A Electric Guitar - Dark", "offers": { "@type": "Offer", "url": "https://search.google.com/Yamaha-2017-BB735A-Electric-Guitar-Dark?quantity=1", "availability": "http://schema.org/InStock", "price": "769.00", "priceCurrency": "USD" }, "review": [] }, </script>