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.

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

Supports over 500 different Schema types and sub-types.

Fixes All Google Search / Rich Results / Merchant Listings 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
• Invalid value in field "priceSpecification"
• 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
• Missing field "image"
• Missing field "address"
• Missing field "telephone"
• Missing field "priceRange"
• Missing field "brand"
• Missing field "aggregateRating"
• Missing field "review"
• No global identifier provided (e.g. gtin mpn isbn)
• Not a known valid target type for the itemReviewed property
• And many more...

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

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

Reads data from remote service APIs, including:

• Get Bitly Short URL
• Get DLMY.App Short URL
• 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

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

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
      • A Custom Field Value for a Schema Property
      • 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
  • 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. When new development versions are available, they will automatically appear under your WordPress Dashboard > Updates page. You can reselect the "Stable / Production" version filter at any time to reinstall the latest stable version.

Changelog / Release Notes

Version 13.11.0 (2022/11/24)

• New Features
  • None.
• Improvements
  • Updated the head markup cache expiration from 1 week to 1 month.
  • Removed the head markup cache expiration adjustment to 1 hour when a cache plugin is detected.
• Bugfixes
  • None.
• Developer Notes
  • Updated the default 'wpsso_cache_expire_head_markup' filter value to 1 month.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 13.10.0 (2022/11/19)

• New Features
  • None.
• Improvements
  • Added the Schema CreativeWork 'citation' and the WebPage 'reviewedBy' and 'lastReviewed' properties.
  • Added new options under the Document SSO > Edit Schema tab:
    • Reference Citations
    • Reviewed By Org.
    • Reviewed By Person
    • Reviewed Last
• Bugfixes
  • None.
• Developer Notes
  • Removed the $start_num argument from SucomForm class methods:
    • SucomForm->get_input_multi()
    • SucomForm->get_select_multi()
    • SucomForm->get_mixed_multi()
    • SucomForm->get_no_input_multi()
    • SucomForm->get_no_select_multi()
    • SucomForm->get_no_mixed_multi()
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 13.9.2 (2022/11/15)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • Fixed an endless loop condition when adding the 'person' role for content creators.
• Developer Notes
  • Removed the $limit argument from these methods:
    • SucomUtil::get_roles_users_ids()
    • SucomUtil::get_roles_users_names()
    • SucomUtil::get_roles_users_select()
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 13.9.0 (2022/11/10)

• New Features
  • None.
• Improvements
  • Added new options under the SSO > Advanced > Plugin Settings > Default Text tab:
    • Term Archive Title
    • Term Archive Description
    • Author Archive Description
  • Added a "Clear WordPress Cron Jobs" button in the SSO > Tools and Actions settings page.
• Bugfixes
  • Fixed a possible condition where a previous custom SEO title or description exists, but the SEO title or description is now disabled (and thus the previous custom SEO title or description cannot be changed).
• Developer Notes
  • Added a new WpssoUtil->count_cron_jobs() method.
  • Added a new 'clear_cron_jobs' action handler in WpssoAdmin->load_setting_page().
  • Added new inline variables:
    • %%term_description%%
    • %%term_hierarchy%%
    • %%term_name%% (aka %%term%%)
    • %%term_tax_single%%
    • %%term_tax_single_lower%%
  • The '%%term_title%%' inline variable no longer includes parent names. Use '%%term_hierarchy%%' if you wish to include parent names in the term title.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 13.8.0 (2022/11/04)

• New Features
  • None.
• Improvements
  • Added a check for is_sitemap() to skip importing and handling unused data for sitemaps (custom fields, content blocks, WooCommerce metadata defaults, and sanitizing metadata).
• Bugfixes
  • Fixed a possible conflict between resized image filenames for cropped and uncropped images.
• Developer Notes
  • Added a SucomDebug->caller() method to log the calling class and method names.
  • Added a WpssoUtilRobots->get_content_directives() method to convert a robots string to an associative array.
  • Added a 'og:redirect_url' non-standard / internal meta tag.
  • Added a '_wpsso_head_info_is_noindex' metadata key with dynamic boolean value.
  • Added a '_wpsso_head_info_is_redirect' metadata key with dynamic boolean value.
  • Added DEBUG_BACKTRACE_IGNORE_ARGS to debug_backtrace() in the SucomDebug class.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 13.7.0 (2022/10/28)

• New Features
  • None.
• Improvements
  • Moved the Document SSO metabox Schema HowTo and Recipe options from the Premium to the Standard edition.
• Bugfixes
  • None.
• Developer Notes
  • Added a new WpssoUtil->get_sitemaps_images() method.
  • Added a new SucomUtil::get_first_og_image_id() method.
  • Added a new SucomUtil::get_first_mt_media_id() method.
  • Renamed the WpssoMedia->get_media_value() method to WpssoMedia->get_mt_media_value().
  • Renamed the WpssoUtil->get_link_rel_alternates() method to WpssoUtil->get_sitemaps_alternates().
  • Renamed the 'wpsso_link_rel_alternates' filter to 'wpsso_sitemaps_alternates'.
  • Refactored the WpssoMessages->wp_sitemaps_disabled() method.
  • Refactored the SucomUtil::get_first_mt_media_url() method.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 13.6.2 (2022/10/23)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • Fixed an argument #1 is not an array error in the WpssoUser->get_public_ids() method.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 13.6.1 (2022/10/20)

• New Features
  • None.
• Improvements
  • Refactored the WpssoPost->get_public_ids() and WpssoUser->get_public_ids() methods to reduce the potential of exceeding PHP memory limits with large databases.
• Bugfixes
  • None.
• Developer Notes
  • Updated the default 'WPSSO_SCHEMA_PRODUCT_VALID_MAX_TIME' constant value from 3 months to 1 year.
  • Added a new WpssoUtilWP::get_posts() method used by the refactored WpssoPost->get_public_ids() method.
  • Renamed WpssoUser::get_person_names() to WpssoUser::get_persons_names().
  • Renamed WpssoUtil::get_roles_user_ids() to WpssoUtil::get_roles_users_ids()
  • Renamed WpssoUtil::get_roles_user_names() to WpssoUtil::get_roles_users_names()
  • Renamed WpssoUtil::get_roles_user_select() to WpssoUtil::get_roles_users_select()
  • Renamed WpssoUtil::get_user_ids() to WpssoUtil::get_users_ids()
  • Renamed WpssoUtil::get_user_names() to WpssoUtil::get_users_names()
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 13.6.0 (2022/10/15)

• New Features
  • None.
• Improvements
  • Added a check for at least one "image" property in the Schema Product type.
  • Moved the Document SSO metabox Schema CreativeWork and Article options from the Premium to the Standard edition.
• Bugfixes
  • None.
• Developer Notes
  • Added a reminder notice when the plugin's cache is disabled for debugging.
  • Added a new WpssoEditGeneral class in lib/edit-general.php.
  • Added a new WpssoEditMedia class in lib/edit-media.php.
  • Added a new WpssoEditPrev class in lib/edit-prev.php.
  • Added a new WpssoEditSchema class in lib/edit-schema.php.
  • Added a new WpssoEditValidators class in lib/edit-validators.php.
  • Added a new WpssoEditVisibility class in lib/edit-visibility.php.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 13.5.0 (2022/10/04)

• New Features
  • None.
• Improvements
  • Added 'timeRequired' (aka reading mins) property to Schema Article markup.
  • Added a new SSO > Advanced Settings > Schema Defaults > Article tab:
    • "Default Article Section"
  • Added new Document SSO > Edit Schema options for the Schema Review type:
    • "Subject Street Address"
    • "Subject P.O. Box Number"
    • "Subject City / Locality"
    • "Subject State / Province"
    • "Subject Zip / Postal Code"
    • "Subject Country"
    • "Subject Telephone"
    • "Subject Price Range"
    • "Subject Serves Cuisine"
  • Moved the Document SSO "Article Section" and "Est. Reading Time" option to the Edit Schema tab.
• Bugfixes
  • None.
• Developer Notes
  • Renamed the 'article_section' metadata option key to 'schema_article_section'.
  • Renamed the 'reading_mins' metadata option key to 'schema_reading_mins'.
  • Moved organization and place tooltip messages from the WPSSO OPM add-on to the WPSSO Core plugin.
  • Added a new WpssoMessagesTooltipMetaOrg class in lib/messages-tooltip-meta-org.php.
  • Added a new WpssoMessagesTooltipMetaPlace class in lib/messages-tooltip-meta-place.php.
  • Added a new WpssoMessagesTooltipMetaProduct class in lib/messages-tooltip-meta-product.php.
• 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.