WPSSO Core (Premium)

The Complete Structured Data Plugin for WordPress

Present your content at its best on social sites and in search results - no matter how URLs are shared, reshared, messaged, posted, embedded, or crawled.

Supports over 500 different Schema types.

Provides structured data markup for:

• Facebook / Open Graph
• Google Knowledge Graph
• Google Merchant Feed XML
• Google Rich Results / Rich Snippets
• Image and Video SEO
• Mobile Web Browsers
• oEmbed for LinkedIn, Discord, and Drupal
• Pinterest Rich Pins
• Twitter Cards
• Schema JSON-LD Markup
• Slack
• WhatsApp and Messaging Apps
• WordPress REST API
• WordPress Sitemaps XML

Optimized image sizes for social sites and search engines:

• Google Merchant Feed XML
• Open Graph (Facebook and oEmbed)
• Pinterest Pin It
• Schema 1:1 (Google Rich Results)
• Schema 4:3 (Google Rich Results)
• Schema 16:9 (Google Rich Results)
• Schema Thumbnail
• Twitter Summary Card
• Twitter Summary Card Large Image
• Video Preview Images

Fixes Google Search and Schema Markup Validator 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 review field is recommended.
• No global identifier provided (e.g. gtin mpn isbn).
• Not a known valid target type for the itemReviewed property.

Reads settings and data from active plugins, including:

• All in One SEO Pack
• Co-Authors Plus
• Easy Digital Downloads
• Elementor Website Builder
• Gravity Forms + GravityView
• Perfect WooCommerce Brands
• Polylang
• Product GTIN (EAN, UPC, ISBN) for WooCommerce
• Rate my Post
• SEOPress
• Simple Job Board
• The Events Calendar
• The SEO Framework
• WooCommerce
• WooCommerce Brands
• WooCommerce Currency Switcher
• WooCommerce UPC, EAN, and ISBN
• WooCommerce Show Single Variations
• WP Job Manager
• WP Meta SEO
• WP-PostRatings
• WP Product Review
• WP Recipe Maker
• WPML
• YITH WooCommerce Brands Add-on
• Yoast SEO
• Yotpo Social Reviews for WooCommerce

Imports post, term, and user plugin metadata (active plugin not required), including:

• All in One SEO Pack Metadata
• Rank Math SEO Metadata
• The SEO Framework Metadata
• Yoast SEO Metadata
• Yoast SEO Block Attributes

Users Love the WPSSO Core Plugin

★★★★★ - "Unlike competitors, you can literally customize just about every aspect of SEO and Social SEO if you desire to. [...] This plugin has the most complete JSON-LD markup out of any of them, so you won’t have any errors and warnings in search console for WordPress or WooCommerce sites. You can go crazy customizing everything, or you can just set and forget. There aren’t many plugins that allow the best of both worlds." - kw11

★★★★★ - "This plugin makes getting sites structured data ready extremely easy, and it works flawlessly without any issues. It shows messages on the top bar every step of the way to alert you of any issues until everything is set up correctly. It made all my ecommerce products pass Google's validation tests. Great work." - marguy1

★★★★★ - "This plugin saves me so much time, and it has really lifted my SERP rankings. Most of my keywords I now rank 1-3 position. I also noticed after about a week that my impressions have gone up at least 75%. I upgraded to the pro version which gave me even more options." - playnstocks

Premium Edition Features

Additional options in the SSO > Advanced Settings page and Document SSO metabox.

Reads data from remote service APIs, including:

• Get Bitly Short URL
• Get DLMY.App
• Get Facebook Video Data
• Get Gravatar Image Data
• Get Ow.ly Short URL
• Get Shopper Approved Review Data
• Get Slideshare Presentation Data
• Get Soundcloud Track Data
• Get Stamped.io Review Data
• Get TinyURL Short URL
• Get Vimeo Video Data
• Get Wistia Video Data
• Get WordPress Video Data
• Get Your Own URL Shortener (YOURLS) Short URL
• Get YouTube Video and Playlist Data

Install and Uninstall

• Install the WPSSO Core Plugin
• Uninstall the WPSSO Core Plugin

Plugin Setup

• Setup Guide
• Developer Special: Buy one, Get one Free
• How to Get Better Schema Markup for WooCommerce
• WooCommerce Integration and Fine-Tuning Notes
• Troubleshooting Guide

Frequently Asked Questions

• Does LinkedIn read Facebook / Open Graph meta tags?
• How can I fix a ERR_TOO_MANY_REDIRECTS error?
• How can I fix a generic HTTP 500 error?
• How can I fix a PHP fatal "out of memory" error?
• How can I fix an HTTP error when uploading images?
• How can I have smaller dimensions for the default image?
• How can I see what the Facebook crawler sees?
• How do I create a Schema FAQPage?
• How do I enable WordPress WP_DEBUG?
• How do I fix Google Structured Data > hatom errors?
• How do I remove duplicate meta tags?
• How does WPSSO Core find and select images?
• How does WPSSO Core find and select videos?
• W3C says "there is no attribute 'property'"
• Why are some HTML elements missing or misaligned?
• Why does Facebook show the wrong image / text?
• Why does the Schema Markup Validator show errors?
• Why shouldn't I upload small images to the media library?

Notes and Documentation

• Developer Resources
  • Actions
  • Constants
  • Filters
    • Filter Examples
      • Detect YouTube URL Links as Videos
      • Exclude Schema Markup by Post Type
      • Fix 'hentry' Errors in your Theme Templates
      • Modify the aggregateRating Property
      • Modify the Default Article Section List
      • Set a Custom Field Value to a Schema Property
  • The $mod Variable
• Inline Variables
• Multisite / Network Support

1. 

   The Essential, General, and Advanced settings pages provide all the options you may need, from simple blog sites to advanced e-commerce shops and everything in-between.

Release Schedule

New versions of the plugin are released approximately every week (more or less). New features are added, tested, and released incrementally, instead of grouping them together in a major version release. When minor bugs fixes and/or code improvements are applied, new versions are also released. This release schedule keeps the code stable and reliable, at the cost of more frequent updates.

See release early, release often (RERO) software development philosophy on Wikipedia for more information on the benefits of smaller / more frequent releases.

Version Numbering

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

• {major} = Major structural code changes and/or incompatible API changes (ie. breaking changes).hanges).
• {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 Edition Repositories

• GitHub
• WordPress.org

Development Version Updates

WPSSO Core Premium customers have access to development, alpha, beta, and release candidate version updates:

Under the SSO > Update Manager settings page, select the "Development and Up" (for example) version filter for the WPSSO Core plugin and/or its add-ons. Save the plugin settings and click the "Check for Plugin Updates" button to fetch the latest version information. When new development versions are available, they will automatically appear under your WordPress Dashboard > Updates page. You can always reselect the "Stable / Production" version filter at any time to reinstall the latest stable version.

Changelog / Release Notes

Version 13.5.0-dev.2 (2022/09/29)

• New Features
  • None.
• Improvements
  • Added 'timeRequired' property to Schema Article markup.
  • Added a new SSO > Advanced Settings > Schema Defaults > Article tab:
    • "Default Article Section"
  • Moved the Document SSO "Article Section" and "Est. Reading Time" option to the Schema tab.
• Bugfixes
  • None.
• Developer Notes
  • Added a new WpssoMessagesTooltipMetaProduct class in lib/messages-tooltip-meta-product.php.
  • Renamed the 'article_section' and 'reading_mins' metadata option keys to 'schema_article_section' and 'schema_reading_mins'.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 13.4.1 (2022/09/26)

• New Features
  • None.
• Improvements
  • Removed duplicated 'price', 'priceCurrency', and 'eligibleQuantity' from the Schema Product offer (already included in the offer 'priceSpecification' markup).
• Bugfixes
  • None.
• Developer Notes
  • Added a new WpssoSchema::get_schema_units() method.
  • Refactored the WpssoAdmin::get_option_unit_comment() method.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 13.4.0 (2022/09/25)

• New Features
  • None.
• Improvements
  • Renamed the "Product Type" option to "Product Google Category".
  • Added a new SSO > Advanced Settings > Schema Defaults > Product tab:
    • "Default Product Google Category"
    • "Default Product Price Type"
    • "Default Product Condition"
    • "Default Product Age Group"
    • "Default Product Adult Oriented"
  • Added new options in the SSO > Advanced Settings page:
    • "Product Age Group Custom Field"
    • "Product Adult Oriented Custom Field"
    • "Age Group Attribute Name"
    • "Adult Oriented Attribute Name"
  • Added new options in the Document SSO metabox:
    • "Product Age Group"
    • "Product Adult Oriented"
  • Added support for new Schema Product 'audience' properties:
    • 'suggestedMinAge'
    • 'suggestedMaxAge'
  • Added support for new Schema Product 'hasAdultConsideration' property.
• Bugfixes
  • None.
• Developer Notes
  • Renamed option keys:
    • 'og_def_product_category' to 'schema_def_product_category'
    • 'og_def_product_condition' to 'schema_def_product_condition'
    • 'og_def_product_price_type' to 'schema_def_product_price_type'
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 13.3.2 (2022/09/22)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • Fixed a missing default 'priceType' value in Schema UnitPriceSpecification markup.
• Developer Notes
  • Updated the SucomUtil->get_mt_image_seed(), get_mt_product_seed(), and get_mt_video_seed() values from an empty string to null.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 13.3.0 (2022/09/15)

• New Features
  • None.
• Improvements
  • Added support for the new 'priceType' property in Schema UnitPriceSpecification markup:
    • Added a new "Product Price Type" option in the Document SSO metabox.
    • Added a new "Default Product Price Type" option in the SSO > General Settings page.
    • Added a new "Product Price Type Custom Field" option in the SSO > Advanced Settings page.
• Bugfixes
  • Fixed SSO > Advanced Settings > Metadata > Custom Fields tab option values (should be blank, not 0) in the WPSSO Core Standard edition.
• Developer Notes
  • Renamed the 'audience_gender' form config array to 'target_gender'.
  • Renamed the 'product:size_type' internal meta tag to 'product:size:type'.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 13.2.1 (2022/09/09)

• New Features
  • None.
• Improvements
  • Updated service API module names.
  • Added support for the WooCommerce > Settings > Advanced > Features > Navigation option (adds the new WooCommerce navigation experience to the dashboard).
• Bugfixes
  • None.
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 13.2.0 (2022/09/06)

• New Features
  • None.
• Improvements
  • Moved SEO import modules from the Premium edition to the Standard edition:
    • Import All in One SEO Pack Metadata
    • Import Rank Math SEO Metadata
    • Import The SEO Framework Metadata
    • Import Yoast SEO Metadata
    • Import Yoast SEO Block Attributes
  • Merged the SSO > Dashboard > Standard Features and Premium Features metaboxes into a new Features Status metabox.
• Bugfixes
  • None.
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 13.1.0 (2022/08/26)

• New Features
  • None.
• Improvements
  • Added support for WP Job Manager job posting company logo.
  • French language translation updates.
• Bugfixes
  • None.
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 13.0.0 (2022/08/24)

• New Features
  • Integration modules for active plugins have been moved to the WPSSO Core Standard edition:
    • All in One SEO Pack
    • Co-Authors Plus
    • Easy Digital Downloads
    • Elementor Website Builder
    • Gravity Forms + GravityView
    • Perfect WooCommerce Brands
    • Polylang
    • Product GTIN (EAN, UPC, ISBN) for WooCommerce
    • Rate my Post
    • SEOPress
    • Simple Job Board
    • The Events Calendar
    • The SEO Framework
    • WooCommerce
    • WooCommerce Brands
    • WooCommerce Currency Switcher
    • WooCommerce UPC, EAN, and ISBN
    • WooCommerce Show Single Variations
    • WP Job Manager
    • WP Meta SEO
    • WP-PostRatings
    • WP Product Review
    • WP Recipe Maker
    • WPML
    • YITH WooCommerce Brands Add-on
    • Yoast SEO
    • Yotpo Social Reviews for WooCommerce
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • URL shortening libraries have been moved to the WPSSO Core Standard edition.
  • Removed support for the WPSSO_PHP_CURL_DISABLE constant.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 12.4.0 (2022/07/31)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • Added a new 'wpsso_product_price' filter for EDD and WooCommerce (Premium edition).
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 12.3.3 (2022/07/18)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • Fixed extra step when importing a Yoast How-To block.
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 12.3.2 (2022/06/27)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • Fixed a few deprecated method arguments in the SucomForm class.
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 12.3.1 (2022/06/20)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • Fixed an incorrect variable name in the AIOSEO integration module (Premium edition).
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 12.3.0 (2022/05/17)

• New Features
  • None.
• Improvements
  • Optimized the saving of images to avoid duplicate thumbnail files.
• Bugfixes
  • None.
• Developer Notes
  • Added a new SucomUtil::sanitize_twitter_name() method.
  • Refactored SucomUtil::get_url() to replace $_SERVER[ 'SERVER_NAME' ] by SucomUtil::get_home_url().
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 12.2.2 (2022/05/10)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • Added more debug messages to the WPML integration module (Premium edition).
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 12.2.0 (2022/04/25)

• New Features
  • None.
• Improvements
  • Added a new "Product Min Advert Price" option in the Document SSO metabox.
  • Added a new "Product Min Advert Price Custom Field" option in the SSO > Advanced Settings page.
• Bugfixes
  • None.
• Developer Notes
  • Added a call to WpssoAbstractWpMeta->get_inherited_md_opts() in WpssoProEcomWoocommerce->add_mt_product().
  • Refactored the WpssoAbstractWpMeta->get_inherited_md_opts() method.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 12.1.1 (2022/04/09)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • Added new filters when getting post/term/user public IDs:
    • 'wpsso_post_public_ids' ( array $public_ids, array $posts_args )
    • 'wpsso_term_public_ids' ( array $public_ids, array $tax_names )
    • 'wpsso_user_public_ids' ( array $public_ids, array $roles )
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 12.1.0 (2022/04/04)

• New Features
  • None.
• Improvements
  • Added a check for any active multilingual plugin to disable the unnecessary custom Schema Language option.
  • Updated the PolyLang and WPML integration modules to provide post/term alternate languages for sitemaps (Premium edition).
• Bugfixes
  • Fixed a possible PHP error in a cron job for required Schema properties.
• Developer Notes
  • Added a new WpssoSchema->get_lang() method.
  • Added a new WpssoUtil->get_link_rel_alternates() method.
  • Added a new 'wpsso_link_rel_alternates' filter.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 12.0.0 (2022/03/26)

Removed support for NextGEN Gallery, NextCellent Gallery, bbPress, BuddyPress, and BuddyBlog.

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.