Schema JSON-LD Markup for Google Rich Results / Rich Snippets with Structured Data | WPSSO Add-on


Uses your pre-existing WordPress content and plugin / API data for accurate and comprehensive Schema JSON-LD markup:

Including image SEO, video SEO, local business, organization, publisher, person, author and co-authors, extensive e-Commerce product markup, product variations, product ratings, aggregate ratings, reviews, recipe information, event details, collection pages, profile pages, search pages, item lists for Google’s Carousel Rich Results, customized property values, and much, much more (see below for Standard and Premium version details).

Offers Schema JSON-LD markup for posts, pages, custom post types, terms (category, tags, etc.), custom taxonomies, user profile pages, search result pages, Accelerated Mobile Pages (AMP) pages, etc.

Most complete Schema JSON-LD markup for WooCommerce products:

The WooCommerce plugin is known to provide incomplete Schema markup for Google. The WPSSO Core Premium plugin and its WPSSO JSON Premium add-on provide a far better solution by offering complete Facebook / Pinterest Product meta tags and Schema Product markup for Google Rich Results / Rich Snippets — including additional product images, product variations, product attributes (brand, color, condition, EAN, dimensions, GTIN-8/12/13/14, ISBN, material, MPN, size, SKU, weight, etc), product reviews, product ratings, sale start / end dates, sale prices, pre-tax prices, VAT prices, and much, much more (markup for a see an example WooCommerce test product).

Fixes all Google Search Console / Structured Data Testing Tool errors:

The Standard and Premium versions both fix all Google testing tool errors for their supported Schema types:

  • A value for the headline field is required.
  • A value for the image field is required.
  • A value for the logo field is required.
  • A value for the publisher field is required.
  • The aggregateRating field is recommended.
  • The brand field is recommended.
  • The headline field is recommended.
  • The image field is recommended.
  • The mainEntityOfPage field is recommended.
  • The review field is recommended.
  • This Product is missing a global identifier.
  • etc.

Google regularly reviews and changes their Schema markup requirements – WPSSO JSON Premium customers can also open a Premium support ticket for assistance with any new Google testing tool errors.

Additional e-Commerce plugin integration is also provided with the WPSSO Core Premium plugin, including Easy Digital Downloads and WP eCommerce.

Users Love the WPSSO JSON Add-on

★★★★★ — “Forget everything else this is the best schema plugin – Sincerely, we bought other plugins that we had to abandon due to the lack of important features, but with this [WPSSO JSON] we get all that we need – and our schema has more features than the competition!” – zuki305

★★★★★ — “Tried three other plugins before this one – for our Woocommerce site, this was by far the best one. Thanks!” – EntoMarket

★★★★★ — “Crazy good! This plugin is one of my favorites! JS aggressively develops and improves this suite of plugins, continuously improving and adding features – with great customer support to boot! Highly recommended to improve your SEO for all kinds of JSON schemas!” – mikegoubeaux

★★★★★ — “This plugin is heaven sent. I know little about SSO and this has taken care of everything. The support makes this an even better plugin to have. Keep up the great work!” – kevanchetty

WPSSO JSON Standard Features

  • Extends the features of the WPSSO Core plugin.

  • Provides Schema properties as JSON-LD markup (aka Google Rich Results / Rich Snippets with Structured Data) for the following Schema types (more specific Schema type properties are available in the Premium version):

  • Automatically includes Schema Article AMP 1:1, 4:3, and 16:9 image sizes for Google Rich Results / Rich Snippets (see the Google Article AMP structured data guidelines for details on this new requirement from Google).

  • Customize the Schema type for each individual posts, pages, custom post types, tags, categories, custom taxonomy / terms, and attachment pages.

  • Provides complete Schema ImageObject SEO markup with attachment data from the WordPress Media Library (name, alternateName, alternativeHeadline, caption, description, fileFormat, uploadDate, and more).

  • Built-in support for AMP, Better AMP, and AMP for WP plugins.

  • Includes contributor markup for Co-Authors Plus authors and guest authors (WPSSO Core Premium plugin required).

  • Adds a Schema Markup settings page to the SSO menu with additional options:

    • Knowledge Graph
      • Knowledge Graph for Home Page
        • Include WebSite Information for Google Search
        • Include Organization Social Profile for a Business Website
        • Include Person Social Profile for a Personal Website
      • User for Person Social Profile
    • Schema Properties
      • WebSite Name
      • WebSite Alternate Name
      • WebSite Description
      • Organization Logo URL
      • Organization Banner URL
      • Maximum Images to Include
      • Schema Image Size
      • Schema Article Image Size
      • Schema Article AMP 1:1 Image Size
      • Schema Article AMP 4:3 Image Size
      • Schema Article AMP 16:9 Image Size
      • Schema Thumbnail Image Size
      • Maximum Description Length
      • Maximum Text Property Length
      • Add CreativeWork Text Property
      • Add 5 Star Rating If No Rating
    • Schema Types
      • Type for Blog Front Page
      • Type for Static Front Page
      • Type for User / Author Page
      • Type for Search Results Page
      • Type for Other Archive Page
      • Type by Post Type for Posts, Pages, Media, Post Type Archive Page, and custom post types
      • Type by Taxonomy for Categories, Tags, and custom taxonomies
    • Integration (WPSSO Core Premium required)
      • Product Attribute Names
        • Product Brand Attribute Name
        • Product Color Attribute Name
        • Product Condition Attribute Name
        • Product Depth Attribute Name
        • Product MPN Attribute Name
        • Product GTIN-14 Attribute Name
        • Product GTIN-13/EAN Attribute Name
        • Product GTIN-12/UPC Attribute Name
        • Product GTIN-8 Attribute Name
        • Product GTIN Attribute Name
        • Product ISBN Attribute Name
        • Product Material Attribute Name
        • Product Size Attribute Name
        • Product Target Gender Attr. Name
        • Product Volume Attribute Name (ml)
    • Custom Meta (WPSSO Core Premium required)
      • Custom Field Names
        • Microdata Type URLs Custom Field
        • How-To Steps Custom Field
        • How-To Supplies Custom Field
        • How-To Tools Custom Field
        • Image URL Custom Field
        • Product Availability Custom Field
        • Product Brand Custom Field
        • Product Color Custom Field
        • Product Condition Custom Field
        • Product Currency Custom Field
        • Product Depth Custom Field (cm)
        • Product GTIN-14 Custom Field
        • Product GTIN-13/EAN Custom Field
        • Product GTIN-12/UPC Custom Field
        • Product GTIN-8 Custom Field
        • Product GTIN Custom Field
        • Product Height Custom Field
        • Product ISBN Custom Field
        • Product Length Custom Field (cm)
        • Product Material Custom Field
        • Product MPN Custom Field
        • Product Price Custom Field
        • Product Size Custom Field
        • Product SKU Custom Field
        • Product Target Gender Custom Field
        • Product Volume Custom Field (ml)
        • Product Weight Custom Field (kg)
        • Product Width Custom Field (cm)
        • Recipe Ingredients Custom Field
        • Recipe Instructions Custom Field
        • Same-As URLs Custom Field
        • Video Embed HTML Custom Field
        • Video URL Custom Field
    • Meta Defaults
      • Creative Work Information
        • Default Family Friendly
        • Default Publisher
        • Default Provider
      • Event Information
        • Default Organizer Org.
        • Default Organizer Person
        • Default Performer Org.
        • Default Performer Person
        • Default Event Venue
      • Job Posting Information
        • Default Hiring Organization
        • Default Job Location

WPSSO JSON Premium Features

The Standard version is designed to satisfy the requirements of most standard WordPress sites / blogs. If your site requires additional Schema properties, for WooCommerce products, events, places / locations, recipes, etc., then you may want the Premium version for those additional features.

Schema JSON-LD Markup Examples

WPSSO Core Plugin Required

WPSSO Schema JSON-LD Markup (aka WPSSO JSON) is an add-on for the WPSSO Core plugin.


  • WPSSO JSON settings page with options for site name, alternate name, logo, banner, image size, and Schema types for posts, pages, custom post types, etc.
  • WPSSO JSON options in the Document SSO metabox for the Schema type


November 24, 2019
I like this plugin because it allows me to enter my UPC code for product descriptions and it fills in the various schema tags posts and products need. Easy enough to use, though I'm still learning some of the ins and outs. I'm happy I paid for the premium version.
November 11, 2019
I installed the plug-in based on this line from description: "Fixes ALL Google Search Console / Structured Data Testing Tool errors" Foolishly, I thought that was referring to THIS plug-in; you know, seeing as it is written on the description for the plugin. But, nope... Turns out if you want to "fix" the errors, you also have install another plug-in, and then upgrade that. Further more, when running a Google meta test prior to install using the std WC meta, I have 3 warnings, and zero errors. Add the plug-in, and the warnings jump up, PLUS, an error is added as the plug-in creates an error when it over-writes the WC meta. But, I guess I could PAY to upgrade and have that "error" fixed... no thank you
Oktober 30, 2019
This particular plug is very useful - and the Premium version is even better, and not all that expensive, either. The BEST feature, though is the first-rate support; the author is quick to respond to questions both on the paid side and the public (forum) side of things. Couldn't ask for more of a plugin! You will also learn a lot about WordPress SEO just by setting up this and other WPSSO plugs - invaluable, IMHO.
Oktober 23, 2019
When I've had issues they've helped fix them. I'm in a small niche so I get first page results without trying but adding schema everywhere has still helped immensely. My google impressions are up 400% this year. Obviously this plugin is only a part of working my butt off but it's certainly helped.
Read all 47 reviews

Contributors & Developers

“Schema JSON-LD Markup for Google Rich Results / Rich Snippets with Structured Data | WPSSO Add-on” is open source software. The following people have contributed to this plugin.


“Schema JSON-LD Markup for Google Rich Results / Rich Snippets with Structured Data | WPSSO Add-on” has been translated into 5 locales. Thank you to the translators for their contributions.

Translate “Schema JSON-LD Markup for Google Rich Results / Rich Snippets with Structured Data | WPSSO Add-on” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.


Version Numbering

Version components: {major}.{minor}.{bugfix}[-{stage}.{level}]

  • {major} = Major structural code changes / re-writes or incompatible API changes.
  • {minor} = New functionality was added or improved in a backwards-compatible manner.
  • {bugfix} = Backwards-compatible bug fixes or small improvements.
  • {stage}.{level} = Pre-production release: dev < a (alpha) < b (beta) < rc (release candidate).

Standard Version Repositories

Development Updates for Premium Users

Development, alpha, beta, and release candidate updates are available for Premium users.

Under the SSO > Update Manager settings page, select the “Development and Up” version filter for WPSSO Core and all its extensions (to satisfy any version dependencies). Save the plugin settings, and click the “Check for Updates” button to fetch the latest / current WPSSO version information. When new Development versions are available, they will automatically appear under your WordPress Dashboard > Updates page. You can always re-select the “Stable / Production” version filter at any time to re-install the last stable / production version of a plugin.

Changelog / Release Notes

Version 2.17.0 (2019/12/08)

  • New Features
    • None.
  • Improvements
    • Added new options in the Document SSO metabox for the Schema Review type:
      • Subject of the Review
        • Subject Same-As URL
        • Subject Image ID or URL
        • Creative Work Subject Information
          • CW Created Date
        • Movie Subject Information
          • Movie Cast Names
          • Movie Director Names
  • Bugfixes
    • None.
  • Developer Notes
    • None.
  • Requires At Least
    • PHP v5.5.
    • WordPress v3.9.
    • WPSSO Core v6.15.0.

Version 2.16.0 (2019/11/30)

  • New Features
    • None.
  • Improvements
    • Added new options in the Document SSO metabox for reviews of products:
      • Product Brand
      • Product Offers (name, price, currency, availability)
      • Product SKU
      • Product MPN
  • Bugfixes
    • None.
  • Developer Notes

Version 2.15.1 (2019/11/23)

  • New Features
    • None.
  • Improvements
    • None.
  • Bugfixes
    • None.
  • Developer Notes
    • Updated WpssoJsonRegister->activate_plugin() for the new WpssoUtilReg class in WPSSO Core v6.13.1.

Version 2.15.0 (2019/11/01)

  • New Features
    • None.
  • Improvements
    • Added a new “Reviewed Item Information” section in the Document SSO metabox:
      • Renamed the “Claim Author Type” option to “Item Author Type”.
      • Renamed the “Claim Author Name” option to “Item Author Name”.
      • Renamed the “Claim Author URL” option to “Item Author URL”.
      • Renamed the “Claim Made on Date” option to “Item Publish Date”.
      • Added a new “Book ISBN” option.
  • Bugfixes
    • None.
  • Developer Notes
    • Added a new lib/filters-messages.php library file.
    • Added a new lib/filters-schema.php library file.
    • Refactored the WpssoJsonSchema::get_type_row_class() method.
    • Refactored the lib/pro/head/review.php filter for
    • Refactored the lib/pro/head/claimreview.php filter for

Version 2.14.0 (2019/10/22)

  • New Features
    • None.
  • Improvements
    • Added a new “Reviewed Item Type” option in the Document SSO metabox.
    • Added a new “Default Reviewed Subject Type” option under the SSO > Schema Markup > Meta Defaults tab.
    • The Schema ‘itemReviewed’ property type can now be managed by the “Reviewed Item Type” option in the Document SSO metabox.
  • Bugfixes
    • None.
  • Developer Notes
    • Update method arguments for SucomForm->get_select() in WPSSO Core v6.9.0.

Version 2.13.2 (2019/10/18)

  • New Features
    • None.
  • Improvements
    • Added filter hooks to disable the new ‘woocommerce_structured_data_review’ and ‘woocommerce_structured_data_website’ filters in WooCommerce v3.7.1 (Premium version).
  • Bugfixes
    • None.
  • Developer Notes
    • None.

Version 2.13.1 (2019/10/14)

  • New Features
    • None.
  • Improvements
    • None.
  • Bugfixes
    • None.
  • Developer Notes
    • Removed a call to WpssoSchema filter_json_data_https_schema_org_localbusiness() since it is no longer exists – local businesses are now automatically filtered through the organization filter (Premium version).

Version 2.12.0 (2019/10/04)

  • New Features
    • None.
  • Improvements
    • Added a License URL option for Schema CreativeWork in the Document SSO metabox.
    • Added pre-rendering of Article AMP images when creating Schema Article non-AMP markup.
  • Bugfixes
    • None.
  • Developer Notes
    • None.

Version 2.11.1 (2019/09/30)

  • New Features
    • None.
  • Improvements
    • Minor update for How-To Step option layout in the Document SSO metabox.
  • Bugfixes
    • None.
  • Developer Notes
    • None.

Version 2.11.0 (2019/09/26)

  • New Features
    • None.
  • Improvements
    • Minor update for Event Offer availability option CSS in the Document SSO metabox.
  • Bugfixes
    • None.
  • Developer Notes
    • Moved Schema Job markup for the hiring organization and location to the WpssoSchemaSingle::add_job_data() method.
    • Moved Schema Event markup for the location, organizers, and performers to the WpssoSchemaSingle::add_event_data() method.

Version 2.10.0 (2019/09/22)

Follows the latest Review snippet structured data guidelines from Google instead of the official Schema standard.

  • New Features
    • None.
  • Improvements
    • Updated the Schema ‘aggregateRating’ and ‘review’ property hooks to limit their addition to only Google approved Schema types (see the Google Review snippet structured data guidelines webpage for details).
      • The official Schema standard provides ‘aggregateRating’ and ‘review’ properties for these types:
        • Brand
        • CreativeWork
        • Event
        • Offer
        • Organization
        • Place
        • Product
        • Service
      • Unfortunately, Google only supports ‘aggregateRating’ and ‘review’ properties for these types:
        • Book
        • Course
        • Event
        • HowTo (includes the Recipe sub-type)
        • LocalBusiness
        • Movie
        • Product
        • SoftwareApplication
      • And the ‘review’ property for these types:
        • CreativeWorkSeason
        • CreativeWorkSeries
        • Episode
        • Game
        • MediaObject
        • MusicPlaylist
        • MusicRecording
        • Organization
  • Bugfixes
    • None.
  • Developer Notes
    • None.

Version 2.9.0 (2019/09/17)

New image dimensions (1:1, 4:3, and 16:9) in Schema Article AMP page markup for Google.

  • New Features
    • None.
  • Improvements
    • Added new image dimensions in Schema Article AMP page markup for Google:
      • Schema Article AMP 1:1 (Google).
      • Schema Article AMP 4:3 (Google).
      • Schema Article AMP 16:9 (Google).
    • Added the ‘uploadDate’ and ‘identifier’ properties to Schema ImageObject markup.
    • Added image selection options in the Document SSO metabox for each Schema HowTo step.
  • Bugfixes
    • None.
  • Developer Notes
    • None.