WPSSO Core – The Complete Meta Tag and Schema Markup Solution


Makes sure your content looks great on all social and search sites – no matter how webpage URLs are crawled, shared, re-shared, posted, or embedded:

The WPSSO Core plugin for WordPress offers comprehensive and accurate information about your content to social sites (Facebook, Pinterest, Twitter, LinkedIn, etc.), search engines and crawlers (Google, Bing, etc.), mail and text messaging apps (Facebook Messenger, iMessage, Skype, WhatsApp, etc.), REST API clients, and oEmbed data for embedded objects / iframes.

Uses your existing WordPress content for meta tags and Schema markup:

There’s no need to manually enter descriptions, titles, product information, select images / videos, etc. — WPSSO Core reads your existing post, page, product, media, recipe, event, forum, and SEO content automatically, and offers fine-tuning and customization options for just about anything and everything. 😉

WPSSO Core is also language / locale aware, which means you can customize your site information, social page URLs and Knowledge Graph for different languages.

Creates complete and accurate meta tags and Schema markup:

WPSSO Core and its optional add-ons offer meta tags and Schema markup for Facebook / Open Graph, Google’s Knowledge Graph, Google Rich Results / Structured Data, Mobile Web Browsers, oEmbed data for LinkedIn, Pinterest Rich Pins, Twitter Cards, Weibo and many more — including complete markup for image SEO, video SEO, extensive e-Commerce product markup (for WooCommerce and others), mobile apps, author profile / authorship, co-authors, publisher information, local business markup, aggregate ratings, reviews, recipe information, event details, and much, much more — all from your existing WordPress content!

Includes advanced quality assurance features and options:

  • Checks for minimum / maximum image dimensions and aspect ratios.
  • Shows notices for missing and required images.
  • Verifies webpages for duplicate meta tags.
  • Validates theme header templates for correct HTML markup.
  • Checks and warns of any missing PHP modules.
  • Checks 3rd party plugin settings for possible conflicts.

Users Love the WPSSO Core Plugin

★★★★★ — “The plugin is indispensable to me when it comes to posting on social media… it makes it so that your posts look the best that they possible can every time when posting on Facebook, Twitter, or any other site.” – monsuirette

★★★★★ — “What a fantastic plugin. If you want to fix all the errors in search console for structured data, this is the plugin to use. Love it.” – goviral

★★★★★ — “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

★★★★★ — “Yoast on steroids! As an SEO marketer, I love using Yoast for my basic on-page SEO. But Yoast only allows you to enter basic Open Graph social settings. This plugin gives you SO many more options on completing the Open Graph for Facebook, Twitter cards, Pinterest etc. If you use WordPress, I totally recommend using this plugin to help with better rankings in the SERPS!” – gregmontag

WPSSO Core Free / Standard Features

  • *Complete and accurate meta tags for all social sites, search engines, web browser extensions, mail and messaging apps, and embedded object / iframe content.

  • Updates the WordPress oEmbed data and HTML markup with the Open Graph title, description, and image for posts, pages, and custom post types.

  • Provides meta tags and markup for posts, pages, custom post types, tags, categories, custom taxonomy / terms, user profile pages, search pages, and attachment pages.

  • Uses images from numerous sources, including featured, attached, gallery shortcode, images from HTML tags, or a custom fallback image.

  • Image dimension settings for Facebook / Open Graph, Schema markup, Google Rich Results / Structured Data, Pinterest Rich Pins, and Twitter Cards.

  • Contextual help for every plugin option and comprehensive online documentation.

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

  • Supports advanced WordPress configurations, including WordPress Network / Multisite installations and WordPress MU Domain Mapping.

  • Includes advanced quality assurance features and options.

Free Complementary Add-ons

WPSSO Core Premium Features

  • Customize default values in the Document SSO metabox when editing posts, pages, custom post types, terms (categories and tags), custom post types, and user profiles:

    • Customize Text
      • Open Graph Type
      • Default Title
      • Default Description
      • Schema Description
      • Search Description
      • Twitter Card Desc
      • Sharing URL
      • Canonical URL
      • Article Information
        • Article Topic
      • Product Information
        • Product Brand
        • Product Availability
        • Product Price and Currency
        • Product Condition
        • Product Material
        • Product Color
        • Product Target Gender
        • Product Size
        • Product Weight
        • Product SKU
        • Product MPN
        • Product ISBN
    • Priority Media
      • Facebook / Open Graph / Default Media
        • Priority Image Information
          • Maximum Images
          • Image ID
          • or Image URL
        • Priority Video Information
          • Include Preview Images
          • Maximum Videos
          • Video Size
          • or Video URL
          • Video Name / Title
          • Video Description
      • Twitter Card
        • Image ID
        • or Image URL
        • Structured Data / Schema Markup / Pinterest
        • Maximum Images
        • Image ID
        • or Image URL
  • Additional custom Schema options are available from the WPSSO Schema JSON-LD Markup Premium add-on:

    • All Schema Types
      • Schema Type
      • 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
      • Provider
    • Event Information
      • Event Language
      • Event Organizer Org
      • Event Organizer Person
      • Event Performer Org
      • Event Performer Person
      • Event Venue
      • 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, and direction text)
    • Job Posting Information
      • Job Posting Job Title
      • Job Posting Hiring Organization
      • Job Posting Job Location
      • Job Posting Base Salary
      • Job Posting Employment Type
      • Job Posting Expires
    • Movie Information
      • Cast Names
      • Director Names
      • Production Company
      • Movie Runtime
    • Organization Information
      • Organization
    • Person Information
      • Person
    • Product Information (Additional)
      • Product Length (cm)
      • Product Width (cm)
      • Product Height (cm)
      • Product Depth (cm)
      • Product 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
      • Recipe Cooking Method
      • Recipe Preparation Time
      • Recipe Cooking Time
      • Recipe Total Time
      • Recipe Total Calories
      • Recipe Ingredients
      • Recipe Instructions
      • Recipe Nutrition Information per Serving
        • Serving Size
        • Calories
        • Protein
        • Fiber
        • Carbohydrates
        • Sugar
        • Sodium
        • Fat
        • Saturated Fat
        • Unsaturated Fat
        • Trans Fat
        • Cholesterol
    • Review Information
      • Review Subject URL
      • Review Rating
      • Review Rating Name
    • Claim Review Information
      • Claim Short Summary
      • Claim Made on Date
      • Claim Author Type
      • Claim Author Name
      • Claim Author URL
      • First Appearance URL
    • Software Application Information
      • Operating System
  • Optionally upscale small images from the Media Library for social sharing and Schema markup.

  • Automatically validate all image minimum / maximum dimensions and aspect ratios.

  • Render shortcodes and blocks for accurate description texts and embedded video detection.

  • Additional Facebook, Open Graph, Rich Pin meta tags and Schema markup for videos and e-Commerce products.

  • Support for embedded videos from Facebook, Slideshare, Vimeo, Wistia, and Youtube in content text.

  • Twitter Player Card for embedded videos from Facebook, Slideshare, Vimeo, Wistia, and Youtube.

  • URL shortening with Bitly, DLMY.App, Google, Ow.ly, TinyURL, or YOURLS.

  • Integrates with services and 3rd party plugins for additional image, video, e-Commerce product details, SEO settings, and more.

  • The following integration modules are provided with the Premium plugin, and are automatically loaded when the supported services are required or 3rd party plugins detected.

Coded for Performance

WPSSO Core makes full use of all available caching methods — along with offering advanced caching features like pre-seeding the cache in background. WPSSO Core and its complementary add-ons use only the library files and object classes they need, keeping their code small, fast and light. All code is fully tested and compatible with the latest version of WordPress and PHP v7.x (PHP v5.5 or better required).

Highly Customizable

WPSSO Core offers hundreds of filter hooks to customize its behavior and output, provides extensive developer documentation with examples, includes dozens of 3rd party integration modules in the Premium plugin, and offers several optional complimentary and Premium add-ons to extend WPSSO Core’s functionality.


  • The document SSO metabox offers a preview tab to show an example share using the current Open Graph meta tags.
  • The essential settings page provides a single-page, quick and easy setup.


Frequently Asked Questions

Advanced Documentation and Notes


August 29, 2019
I was looking for a plugin to use that would let me control the data displayed when sharing links. This plugin in did the job and is great!
August 14, 2019
Its a little hard to understand and learn at first but fundamental to get ahead of the game of Google. When you understand it and get it working its great.
August 13, 2019
This plugin is very usefull is full of many features. should be have more documentation about all funtions but is ok by the way.
Read all 210 reviews

Contributors & Developers

“WPSSO Core – The Complete Meta Tag and Schema Markup Solution” is open source software. The following people have contributed to this plugin.


“WPSSO Core – The Complete Meta Tag and Schema Markup Solution” has been translated into 3 locales. Thank you to the translators for their contributions.

Translate “WPSSO Core – The Complete Meta Tag and Schema Markup Solution” into your language.

Interested in development?

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

Change log

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 / 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 6.8.1 (2019/10/18)

  • New Features
    • None.
  • Improvements
    • Minor CSS adjustments for the new WordPress v5.3 form styles.
  • Bugfixes
    • None.
  • Developer Notes
    • None.

Version 6.8.0 (2019/10/14)

  • New Features
    • None.
  • Improvements
    • Added more financial service Schema types to the Schema select list:
      • https://schema.org/BankAccount
      • https://schema.org/BrokerageAccount
      • https://schema.org/CreditCard
      • https://schema.org/DepositAccount
      • https://schema.org/InvestmentFund
      • https://schema.org/MortgageLoan
      • https://schema.org/PaymentCard
  • Bugfixes
    • None.
  • Developer Notes
    • Renamed the SucomUtil array_parent_index() method to get_array_parents(), which now returns an array of (one or more) parents per child instead of a single parent string per child.
    • Updated the WpssoSchema get_schema_type_child_family() and get_schema_type_children() methods to handle an array of parents instead of a single parent string.
    • Removed the WpssoSchema filter_json_data_https_schema_org_localbusiness() method since it is no longer required – local businesses are now automatically filtered through the organization filter.

Version 6.7.1 (2019/10/08)

  • New Features
    • None.
  • Improvements
    • None.
  • Bugfixes
    • Fixed possible non-unique image filename conflicts by copying instead or renaming cropped images.
  • Developer Notes
    • None.

Version 6.7.0 (2019/10/04)

  • New Features
    • None.
  • Improvements
    • Added a default time-to-live of 300 seconds to all notice messages to prevent showing old / expired notices.
  • Bugfixes
    • Fixed missing argument in the WpssoAdmin registered_setting_sanitation() method ‘wpsso_save_options’ filter.
  • Developer Notes
    • Updated the WpssoOptions check_options() and save_options() methods to clear all caches after upgrading the options array.

Version 6.6.0 (2019/09/28)

  • New Features
    • None.
  • Improvements
    • Updated the content video detection patterns to include the new block editor embed tags.
    • Optimized the handling of video preview images to improve selection and avoid duplicates.
  • Bugfixes
    • Fixed fallback to default image for non-singular and non-term pages.
    • Fixed ‘get_avatar’ filter hook for older WP pre-v4.2 sites by removing 6th argument (added in WP v4.2).
  • Developer Notes
    • Moved video preview image selection from WpssoOpenGraph::get_array() to WpssoOpenGraph::get_all_images()
    • Updated the WpssoSchemaSingle::add_job_data() method to allow handling of multiple hiring organization and location IDs.
    • Updated the WpssoSchemaSingle::add_event_data() method to allow handling of multiple location, organizer, and performer IDs.
    • Added a new get_select_multi() and get_no_select_multi() methods in the WpssoForm class.
    • Added local caching to the WpssoOpenGraph::get_all_videos() method.
    • Added a new WpssoOpenGraph::get_all_previews() method.

Version 6.5.0 (2019/09/26)

  • New Features
    • None.
  • Improvements
    • Refactored the post, term, and user get_options() methods to better handle fallback to default values.
  • Bugfixes
    • None.
  • Developer Notes
    • Added a ‘nopin’ attribute to Gravatar images when the Add “nopin” to Site Header Image option is enabled.
    • Moved the ‘nopin’ image attribute filters from the WpssoMedia to the WpssoPinterest class.
    • Removed ‘loading=”lazy”‘ from the hidden Pinterest Pin It button image.
    • Removed the deprecated ‘wpsso_get_event_location_id’ filter since selecting a Schema Place in the Document SSO metabox forces the Schema type to a place.

Version 6.4.0 (2019/09/22)

Added a new ‘oEmbed’ tab in the Document SSO metabox.

  • New Features
    • Added a new ‘oEmbed’ tab in the Document SSO metabox to show the oEmbed data and oEmbed HTML.
  • Improvements
    • Improved WordPress oEmbed data and HTML markup with the Open Graph image, title, and description.
  • Bugfixes
    • Fixed the “Select Image” button to trigger a jQuery change() event on the image ID input field.
  • Developer Notes
    • None.

Version 6.3.1 (2019/09/17)

New Schema Article AMP image sizes for the WPSSO JSON add-on.

  • New Features
    • None.
  • Improvements
    • Added a new “Notification System” option to the Essential and Advanced settings page.
    • Added new Schema Article AMP image dimensions for Google (WPSSO JSON add-on required):
      • 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 ‘loading=”lazy”‘ to the hidden Pinterest Pin It button image.
    • Removed the “Meta Property Container” option (the WPSSO JSON add-on is a better alternative).
  • Bugfixes
    • None.
  • Developer Notes
    • Added checks for AMP, Better AMP, and AMP for WP plugins in WpssoCheck::get_avail().
    • Added an ‘image’ input type in the SucomForm::get_mixed_multi() method for WPSSO JSON v2.9.0.
    • Added a lib/schema-noscript.php library file with a single filter for aggregate rating markup (replaces the lib/noscript.php library file).
    • Added a lib/oembed.php library file (methods to be added in v6.4.0).
    • Removed the lib/noscript.php library file.
    • Removed the lib/schema-cache.php library file (Deprecated).
    • Updated the SuextMobileDetect class from https://github.com/serbanghita/Mobile-Detect v2.8.28 to v2.8.33.

Version 6.2.0 (2019/09/07)

Complete re-write of the WP eCommerce integration module in the Premium version.

  • New Features
    • None.
  • Improvements
    • Added support for sale prices, product variations, and product attributes in the WP eCommerce integration module (Premium version).
  • Bugfixes
    • Fixed the disabled ‘Product Condition’ select option in the Document SSO metabox when the product attribute name is empty (Premium version).
  • Developer Notes
    • Refactored the WP eCommerce integration module (Premium version).
    • Added ‘wpsso_schema_type_id’, and ‘wpsso_the_content_seed’ filters to handle the EDD checkout page (Premium version).
    • Added new $prod_post_type, $taxonomy_cat, and $taxonomy_tag properties in the e-commerce integration modules (Premium version).
    • Added a new SucomUtil::is_mod_post_type() method.
    • Added a new SucomUtil::is_mod_tax_slug() method.
    • Added a new SucomUtil::is_term_tax_slug() method.
    • Removed the SucomUtil::is_product_page() method.
    • Removed the SucomUtil::is_product_category() method.
    • Removed the SucomUtil::is_product_tag() method.