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 for additional product-related schema information.


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: InStock is the default value.

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

  6. Click Save.

JSON-LD Product Schema Properties

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




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


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


Description of the item.


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


Name of the item.


Details about the item offered for sale.


Offer price of the item.


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


Dontent rating.


Review of the item.


Total number of reviews.


Merchant-specific identifier for the item.


URL of the item.

A sample of JSON-LD markup is shown below.

<script type="application/ld+json"> { "@context": "", "@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": "", "image": "", "sku":"Yamaha 2017 BB735A Electric Guitar - Dark", "offers": { "@type": "Offer", "url": "", "availability": "", "price": "769.00", "priceCurrency": "USD" }, "review": [] }, </script>