WPSSO Schema JSON-LD Markup (Premium)

Supports over 500 different Schema (aka Schema.org) types and sub-types:

Google Rich Results with JSON-LD structured data for Articles, Carousels (aka Item Lists), Claim Reviews, Events, FAQ pages, How-Tos, Images, Local Business / Local SEO, Organizations, Products, Ratings, Recipes, Restaurants, Reviews, Video Objects, and much more.

Reads your existing content, plugin data, and service API data:

There's no need to manually re-enter descriptions, titles, product information, and re-select images / videos like other SEO and Schema markup plugins.

Provides comprehensive Schema JSON-LD markup for posts, pages, custom post types, terms (category, tags, etc.), custom taxonomies, user profile pages, search result pages, archive pages, and Accelerated Mobile Pages (AMP) pages - 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, FAQ pages, item lists for Google's Carousel Rich Results, and much more.

Most complete Schema JSON-LD markup for WooCommerce products:

Note that WooCommerce offers incomplete Schema markup for Google Rich Results by default. The WPSSO Core Premium plugin and this add-on provide a solution by offering complete product meta tags for Facebook / Pinterest and complete Schema product markup for Google Rich Results - including additional product images, product variations, product information (brand, color, condition, EAN, dimensions, GTIN-8/12/13/14, ISBN, material, MPN, size, SKU, volume, weight, etc), product reviews, product ratings, sale start / end dates, sale prices, pre-tax prices, VAT prices, shipping rates, shipping times, and much, much more.

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

• 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 (e.g. isbn, mpn or gtin8).
• No global identifier provided (e.g. gtin mpn isbn).
• Not a known valid target type for the itemReviewed property.
• And more...

Some Schema property values may require data from WPSSO Core Premium supported third-party plugins and service APIs.

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

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 Add-on Features

Extends the features of the WPSSO Core plugin (required plugin).

Provides accurate and comprehensive Schema JSON-LD markup for Google Rich Results (aka Rich Snippets) with Structured Data.

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

Provides complete Schema VideoObject SEO markup with video information from WPSSO Core Premium service APIs (Facebook, Slideshare, Soundcloud, Vimeo, Wistia, YouTube) including the 'embedUrl' and 'contentUrl' properties for Google.

Provides Schema 1:1, 4:3, and 16:9 images for Google Rich Results (see the Google rich results search library for details).

Provides Schema FAQPage and Question / Answer markup for the WPSSO FAQ Manager add-on.

Includes Schema JSON-LD scripts from shortcodes and WordPress editor blocks in the Schema CreativeWork type and sub-types.

Built-in support for AMP and AMP for WP plugins.

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

Supports additional custom product information and WooCommerce product attributes from the WPSSO Core Premium plugin:

• Product Availability
• Product Brand
• Product Color
• Product Condition
• Product Depth
• Product Fluid Volume
• Product GTIN-14
• Product GTIN-13 (EAN)
• Product GTIN-12 (UPC)
• Product GTIN-8
• Product GTIN
• Product ISBN
• Product Length
• Product Material
• Product MPN
• Product Price
• Product Size
• Product SKU
• Product Target Gender
• Product Type
• Product Weight
• Product Width

Provides Schema Product markup for Google price drop appearance in search results.

Fixes common Google testing tool warnings like "aggregateRating field is recommended" and "review field is recommended".

Fixes Google testing tool warnings for supported WPSSO Core Premium e-commerce products, like "brand field is recommended", "missing a global identifier", etc.

The WPSSO Schema JSON-LD Markup Standard add-on is designed to satisfy the requirements of most standard WordPress sites. If your content requires additional customization of some Schema properties for products, events, places / locations, recipes, etc., then you may want to get the WPSSO JSON Premium add-on for those additional features.

[Premium] Includes additional customizable option values in the Document SSO metabox (shown based on the Schema Type selected):

• All Schema Types
  • Name (Title)
  • Alternate Name
  • Description
  • Microdata Type URLs
  • Same-As URLs
• Creative Work Information
  • Is Part of URL
  • Headline
  • Full Text
  • Keywords
  • Language
  • Family Friendly
  • Copyright Year
  • License URL
  • Publisher (Org)
  • Publisher (Person)
  • Service Provider (Org)
  • Service Provider (Person)
• Event Information
  • Event Language
  • Event Attendance
  • Event Online URL
  • Event Physical Venue
  • Event Organizer (Org)
  • Event Organizer (Person)
  • Event Performer (Org)
  • Event Performer (Person)
  • Event Start (date, time, timezone)
  • Event End (date, time, timezone)
  • Event Offers Start (date, time, timezone)
  • Event Offers End (date, time, timezone)
  • Event Offers (name, price, currency, availability)
• How-To
  • How-To Makes
  • How-To Preparation Time
  • How-To Total Time
  • How-To Supplies
  • How-To Tools
  • How-To Steps (section name, section description, step name, direction text and image)
• Job Posting Information
  • Job Title
  • Hiring Organization
  • Job Location
  • Job Location Type
  • Base Salary
  • Employment Type
  • Jpb Posting Expires
• Movie Information
  • Cast Names
  • Director Names
  • Production Company
  • Movie Runtime
• Organization Information
  • Select an Organization
• Person Information
  • Select a Person
• Product Information (Additional)
  • Product Length (cm)
  • Product Width (cm)
  • Product Height (cm)
  • Product Depth (cm)
  • Product Fluid Volume (ml)
  • Product GTIN-14
  • Product GTIN-13 (EAN)
  • Product GTIN-12 (UPC)
  • Product GTIN-8
  • Product GTIN
• QA Page Information
  • QA Heading
• Recipe Information
  • Recipe Cuisine
  • Recipe Course
  • Recipe Makes
  • Cooking Method
  • Preparation Time
  • Cooking Time
  • Total Time
  • Recipe Ingredients
  • Recipe Instructions
  • Nutrition Information per Serving
    • Serving Size
    • Calories
    • Protein
    • Fiber
    • Carbohydrates
    • Sugar
    • Sodium
    • Fat
    • Saturated Fat
    • Unsaturated Fat
    • Trans Fat
    • Cholesterol
• Review Information
  • Review Rating
  • Rating Value Name
  • Subject of the Review
    • Subject Webpage Type
    • Subject Webpage URL
    • Subject Same-As URL
    • Subject Name
    • Subject Description
    • Subject Image ID or URL
    • Claim Subject Information (for Claim Review)
      • Short Summary of Claim
      • First Appearance URL
    • Creative Work Subject Information
      • C.W. Author Type
      • C.W. Author Name
      • C.W. Author URL
      • C.W. Published Date
      • C.W. Created Date
    • Book Subject Information
      • Book ISBN
    • Movie Subject Information
      • Movie Cast Names
      • Movie Director Names
    • Product Subject Information
      • Product Brand
      • Product Offers (name, price, currency, availability)
      • Product SKU
      • Product MPN
    • Software App Subject Information
      • Operating System
      • Application Category
      • Software App Offers (name, price, currency, availability)
• Software Application Information
  • Operating System
  • Application Category

WPSSO Core Required

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

Install and Uninstall

• Install the WPSSO Schema JSON-LD Markup add-on.
• Uninstall the WPSSO Schema JSON-LD Markup add-on.

Frequently Asked Questions

• Can I add custom Schema properties to the JSON-LD?
• How do I create a Schema FAQPage?

Notes and Documentation

• Developer Resources
  • Filters
    • All Filters
    • Filter Examples
      • Assign a Custom Field Value to a Schema Property
      • Exclude Schema Markup by Post Type
      • Modify the aggregateRating Property
      • Modify the VideoObject Name and Description
• Schema Shortcode Guide

1. 

   WPSSO JSON settings page with options for the site name, alternate name, logo, banner, image sizes, Schema types, and much more.

2. 

   WPSSO JSON options in the Document SSO metabox for the Schema Article type (Premium version shown).

3. 

   WPSSO JSON options in the Document SSO metabox for a WooCommerce Product (Premium version shown).

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

• GitHub
• WordPress.org

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 Plugin 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 4.17.3 (2021/07/10)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • Removed a check for the 'plugin_cache_date_archive' option when clearing the transient cache.
• Requires At Least
  • PHP v7.0.
  • WordPress v5.0.
  • WPSSO Core v8.35.0.

Version 4.17.2 (2021/06/27)

• New Features
  • None.
• Improvements
  • Added support for a 'name' in the Schema review property markup.
• Bugfixes
  • None.
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.0.
  • WordPress v5.0.
  • WPSSO Core v8.34.0.

Version 4.17.1 (2021/06/23)

• New Features
  • None.
• Improvements
  • Added support for the new "Cache Date Archive Markup" option in WPSSO Core v8.31.0.
• Bugfixes
  • None.
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.0.
  • WordPress v4.5.
  • WPSSO Core v8.32.0.

Version 4.17.0 (2021/06/08)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • Renamed '*_img_id_pre' option keys to '*_img_id_lib' for WPSSO 8.30.0.
• Requires At Least
  • PHP v7.0.
  • WordPress v4.5.
  • WPSSO Core v8.30.0.

Version 4.16.0 (2021/05/30)

• New Features
  • None.
• Improvements
  • Updated the Schema Recipe markup to include instruction sections and images.
• Bugfixes
  • None.
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.0.
  • WordPress v4.5.
  • WPSSO Core v8.29.0.

Version 4.15.1 (2021/05/05)

• New Features
  • None.
• Improvements
  • The Priority Media Schema image selection is now unhidden by default.
• Bugfixes
  • None.
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.0.
  • WordPress v4.5.
  • WPSSO Core v8.28.1.

Version 4.15.0 (2021/04/17)

• New Features
  • None.
• Improvements
  • Added a new "Job Location Type" option in the Document SSO metabox.
  • Added a new "Default Job Location Type" option in the SSO > Schema Markup settings page.
• Bugfixes
  • None.
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.0.
  • WordPress v4.5.
  • WPSSO Core v8.26.3.

Version 4.14.1 (2021/02/25)

• New Features
  • None.
• Improvements
  • Updated the banners and icons of WPSSO Core and its add-ons.
• Bugfixes
  • None.
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.0.
  • WordPress v4.5.
  • WPSSO Core v8.25.2.

Version 4.14.0 (2021/02/09)

To support the new price drop appearance feature in Google search results, product offer markup has been changed to include all offers as a single array (by default) instead of aggregating offers by currency.

• New Features
  • Added a new "Aggregate Offers by Currency" option in the SSO > Schema Markup settings page (unchecked by default).
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.0.
  • WordPress v4.5.
  • WPSSO Core v8.22.0.

Version 4.13.1 (2021/01/29)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • Fixed an incorrect banner image source for the Schema Article publisher property markup.
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.0.
  • WordPress v4.5.
  • WPSSO Core v8.20.0.

Version 4.13.0 (2021/01/21)

• New Features
  • None.
• Improvements
  • Added support for images in each element of the review property.
• Bugfixes
  • None.
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.0.
  • WordPress v4.5.
  • WPSSO Core v8.20.0.

Version 4.12.0 (2020/12/11)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • Removed deprecated $posts_per_page argument from WpssoSchema::add_itemlist_data() method calls.
  • Removed deprecated $posts_per_page argument from WpssoSchema::add_posts_data() method calls.
  • Removed deprecated constants:
    • WPSSO_SCHEMA_POSTS_PER_BLOG_MAX
    • WPSSO_SCHEMA_MENTIONS_PER_COLLECTION_MAX
    • WPSSO_SCHEMA_QUESTIONS_PER_FAQPAGE_MAX
    • WPSSO_SCHEMA_ITEMS_PER_LIST_MAX
    • WPSSO_SCHEMA_MENTIONS_PER_PROFILE_MAX
    • WPSSO_SCHEMA_MENTIONS_PER_SEARCH_MAX
• Requires At Least
  • PHP v7.0.
  • WordPress v4.5.
  • WPSSO Core v8.17.0.

Version 4.11.0 (2020/12/04)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • Included the $addon argument for library class constructors.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.5.
  • WPSSO Core v8.16.0.

Version 4.10.0 (2020/11/26)

• New Features
  • None.
• Improvements
  • Moved all SSO > Schema Markup > Schema Defaults tab options to a new Schema Defaults metabox.
• Bugfixes
  • None.
• Developer Notes
  • None.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.4.
  • WPSSO Core v8.14.0.

Version 4.9.0 (2020/11/20)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • Renamed the 'plugin_def_currency' options key to 'og_def_currency' for WPSSO Core v8.13.0.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.4.
  • WPSSO Core v8.13.0.

Version 4.8.0 (2020/11/13)

• New Features
  • None.
• Improvements
  • Added a check to skip loading Schema filter hooks if Schema markup is disabled.
• Bugfixes
  • None.
• Developer Notes
  • None.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.4.
  • WPSSO Core v8.12.1.

Version 4.7.0 (2020/11/07)

• New Features
  • None.
• Improvements
  • Moved the activation of shipping offers for Schema JSON-LD from WPSSO JSON to WPSSO WCSDT.
• Bugfixes
  • None.
• Developer Notes
  • None.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.4.
  • WPSSO Core v8.11.2.

Version 4.6.0 (2020/10/28)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • Refactored the WpssoJsonFiltersTypePlace class to use WpssoSchemaSingle::get_opening_hours_data() in WPSSO Core v8.10.0.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.4.
  • WPSSO Core v8.10.0.

Version 4.5.2 (2020/10/26)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • Fixed invalid argument error for $weekdays in the WpssoJsonFiltersTypePlace class.
• Developer Notes
  • None.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.4.
  • WPSSO Core v8.9.0.

Version 4.5.1 (2020/10/17)

• New Features
  • None.
• Improvements
  • Refactored the add-on class to extend a new WpssoAddOn abstract class.
• Bugfixes
  • Fixed backwards compatibility with older 'init_objects' and 'init_plugin' action arguments.
• Developer Notes
  • Added a new WpssoAddOn class in lib/abstracts/add-on.php.
  • Added a new SucomAddOn class in lib/abstracts/com/add-on.php.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.4.
  • WPSSO Core v8.8.1.

Version 4.4.0 (2020/10/02)

Added support for the new Schema shippingDetails property in Schema Product offers for WooCommerce products. Note that Google is now showing shipping costs from Schema markup in search results.

• New Features
  • None.
• Improvements
  • Added support for the new Schema shippingDetails property in Schema Product offers for WooCommerce products, including shippingRate values by currency, and shippingDestination with countries, states, and postal code limits (WooCommerce postal code wildcards and ranges are supported).
• Bugfixes
  • None.
• Developer Notes
  • None.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.4.
  • WPSSO Core v8.7.0.

Version 4.3.1 (2020/09/18)

• New Features
  • None.
• Improvements
  • Added a conflict notification for the Yoast WooCommerce SEO plugin.
  • Added new Schema Review sub-types:
    • https://schema.org/CriticReview
    • https://schema.org/EmployerReview
    • https://schema.org/MediaReview
    • https://schema.org/Recommendation
    • https://schema.org/UserReview
• Bugfixes
  • None.
• Developer Notes
  • Added a new WpssoJsonConflict class in lib/conflict.php.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.4.
  • WPSSO Core v8.5.1.

Version 4.3.0 (2020/09/15)

• New Features
  • None.
• Improvements
  • Updated the French plugin translations.
• Bugfixes
  • None.
• Developer Notes
  • Moved extracted translation strings from lib/gettext-*.php files to a new gettext/ folder.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.2.
  • WPSSO Core v8.5.0.

Version 4.2.1 (2020/09/11)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • Added custom CSS filters for Yoast SEO and Rank Math in the WpssoJsonCompat class.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.2.
  • WPSSO Core v8.4.1.

Version 4.2.0 (2020/09/05)

• New Features
  • None.
• Improvements
  • Added Schema cleanup for Yoast SEO to remove its Schema JSON-LD markup.
  • Added Schema cleanup for Rank Math to remove its Schema JSON-LD markup, except for the Schema BreadcrumbList markup.
• Bugfixes
  • None.
• Developer Notes
  • Added a lib/compat.php library file for third-party plugin and theme compatibility actions and filters.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.2.
  • WPSSO Core v8.3.0.

Version 4.1.0 (2020/08/15)

Google has updated their Rich Results requirements to use the complete URL of Schema enumeration values instead of only the enumeration name (as they previously required). The product availability, product condition, event attendance, event status, and offer availability values have all been updated to include their complete enumeration URL. For example, a previous product condition might have been 'New' or 'NewCondition' and will now be included in Schema markup as 'https://schema.org/NewCondition'.

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • Added a new 'wpsso_sanitize_md_options' filter hook in WpssoJsonFilters to sanitize the post metadata event attendence, event status, and offer availability values.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.2.
  • WPSSO Core v8.2.1.

Version 4.0.0 (2020/08/11)

Google has updated their Rich Results requirements and now prefers 1:1, 4:3, and 16:9 images for all Schema types, not just the Schema Article type for AMP webpages. The "Schema" and "Schema Article" image sizes have been removed and replaced by new Schema 1:1, 4:3, and 16:9 image sizes (minimum dimensions are 1200x1200px, 1200x900px, and 1200x675px).

• New Features
  • None.
• Improvements
  • Added an 'audience' property to Schema Product markup for the Target Gender value.
  • Renamed the following SSO > Image Sizes:
    • Schema Article AMP 1:1 to Schema 1:1 (Google)
    • Schema Article AMP 4:3 to Schema 4:3 (Google)
    • Schema Article AMP 16:9 to Schema 16:9 (Google)
  • Removed the following SSO > Image Sizes:
    • Schema
    • Schema Article
• Bugfixes
  • None.
• Developer Notes
  • Added support for the new WpssoUtilMetabox class in WPSSO Core v8.0.0.
  • Refactored the get_missing_requirements() and wpsso_init_textdomain() methods to allow reloading translation files when debugging is enabled.
  • Refactored the Schema type filters to use the new WpssoSchema::is_valid_key() and is_valid_val() from WPSSO Core v8.0.0.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.2.
  • WPSSO Core v8.0.0.