Structured Data Markup

The JSON-LD Strutured Data Format feature requires:

SuiteCommerce or SuiteCommerce 2020.1 (or later)
A theme based on the 2020.1 (or later) Base Theme.

Major search engines use structured data markup to discover detailed information about a page and enhance search results.

Note:

The URL for parent and child matrix items is the same and will be tracked as the same by search engines.

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 websites 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

In NetSuite, go to Commerce > Websites > Configuration.
Select your website and domain and click Configure.
In the configuration record, go to the Shopping Catalog tab and the Structured Data Markup subtab.
Select JSON-LD in the Markup Type field to add JSON-LD to all product detail pages. Select the No Markup option to prevent markup from being added to the product detail pages.
Select an Out of Stock Behavior. These options only apply when backorders are permitted.

Options include:
- InStock. Select this option when backorders are permitted and availability property markup will be set to: http://schema.org/InStock. InStock is the default value.
- PreOrder. Select this option when backorders are permitted and availability property markup will be set to; http://schema.org/PreOrder.
Click Save.

JSON-LD Product Schema Properties

SuiteCommerce and SuiteCommerce Advanced use the properties listed in the table 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 backorders are permitted. 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.

See the following sample of JSON-LD markup:

            <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>

Setup

Enable Structured Data Markup

JSON-LD Product Schema Properties

Related Topics