WPSSO – Advanced Plugin for Social Meta Tags / SEO, Schema Markup and Knowledge Graph


WPSSO uses your existing content to create meta tags + Schema markup — there’s no need to manually enter / configure any additional settings or values, but if you want to, you can customize just about anything and everything. 😉

WPSSO creates complete and accurate meta tags + Schema markup — including hashtags, video seo, e-commerce products, author profile / authorship, co-authors, publisher information, ratings, event details, recipe information, and much more — all from your existing content.

WPSSO offers special optimization features for Pinterest — providing an image for the Pin It button, excluding non-relevant images, and preventing conflicts between incompatible Pinterest and Facebook meta tag values.

WPSSO includes advanced quality control features and options — checking minimum / maximum image dimensions and aspect ratios, verifying the webpage for duplicate meta tags, showing notices for missing and required images, along with theme header template validation.

WPSSO can enhance and integrate with your favorite SEO plugin! — WPSSO specializes in providing all the meta tags + Schema markup social sites and search engines need, and you can still continue to use your favorite SEO content / keyword analysis tools!

WPSSO offers a fast and reliable social framework for developers — offering dozens of 3rd party integration modules in the Pro version, several Free and Pro extensions, and hundreds of filter hooks to easily customize WPSSO’s behavior and output.

Quick List of Features

WPSSO Free / Standard Features

Download the Free version from GitHub or WordPress.org.

Quick List of Features (Continued)

WPSSO Pro / Additional Features

  • Includes a Social Settings metabox for Post, Page, custom post type, user profile, and term / taxonomy (category and tag) editing pages — the Social Settings metbox allows you to customize the article topic, the shared title, the Open Graph / Facebook / Rich Pin, Google Search, and Twitter Card descriptions, along with the shared image and/or video.
  • Fully renders content (including shortcodes) for accurate description texts.
  • Support for embedded videos in content text (iframe and object HTML markup).
  • Additional Facebook / Open Graph / Rich Pin meta tags for videos and e-commerce products.
  • Twitter Player Card meta tags for embedded videos from Facebook, Slideshare, Vimeo, Wistia, and/or Youtube.
  • Include or exclude individual Google / SEO, Open Graph, Twitter Card, and Schema meta tags in the webpage head section.
  • Validation of minimum / maximum image dimensions and aspect ratios.
  • Configurable user profile contact field names and labels.
  • Optional URL shortening with Bitly, Google, Ow.ly, TinyURL, or YOURLS.
  • Integrates with 3rd party plugins and services for additional image, video, e-commerce product details, SEO settings, etc. The following modules are included with the Pro version, and are automatically loaded if/when the supported plugins and/or services are required.
    • Integration with 3rd Party Plugins
      • All in One SEO Pack
      • bbPress
      • BuddyPress (including Group Forum Topics)
      • Co-Authors Plus (including Guest Authors)
      • Easy Digital Downloads
      • Gravity Forms + GravityView
      • HeadSpace2 SEO
      • MarketPress – WordPress eCommerce
      • NextGEN Gallery
      • Polylang
      • rtMedia for WordPress, BuddyPress and bbPress
      • The Events Calendar
      • The SEO Framework
      • WooCommerce (version 1, 2, and 3)
      • WordPress REST API (version 2)
      • WP eCommerce
      • Yoast SEO (aka WordPress SEO)
      • Yotpo Social Reviews for WooCommerce
    • Integration with Service APIs
      • Bitly
      • Facebook Embedded Videos
      • Google URL Shortener
      • Gravatar (Author Image)
      • Ow.ly
      • Slideshare Presentations
      • TinyURL
      • Vimeo Videos
      • Wistia Videos
      • Your Own URL Shortener (YOURLS)
      • YouTube Videos and Playlists
  • Additional Pro extension plugins:

Purchase the Pro version (includes a No Risk 30 Day Refund Policy).

Social Profiles for Google Search

WPSSO includes support for author (Person) and publisher (Organization) social profiles, publisher (Organization) logo, and WebSite site name in Schema JSON-LD format for Google Search and their Knowledge Graph.

User Profile Social Contacts

WPSSO Pro allows you to customize the field names, label, and add / remove the following contacts on user profile pages and Co-Authors Plus guest author profiles:

  • AIM
  • Facebook URL
  • Google Talk
  • Google+ URL
  • Instagram URL
  • LinkedIn URL
  • MySpace URL
  • Pinterest URL
  • Skype Username
  • Tumblr URL
  • Twitter @username
  • Yahoo IM
  • YouTube Channel URL

Complete Social Meta Tags

WPSSO adds Facebook / Open Graph, Pinterest Rich Pins, Twitter Cards, and Search Engine Optimization (SEO) meta tags to the head section of webpages. These meta tags are used by Google Search and all social websites to describe and display your content correctly (title, description, hashtags, images, videos, e-commerce product details, author profile / authorship, publisher, etc.). WPSSO uses existing content to generate meta tags + Schema markup — there’s no need to manually enter / configure any additional settings or values.

3rd Party Integration (Pro version)

Images and Videos

WPSSO detects and uses all images – associated or included in your content – including the WordPress image gallery and NextGEN Gallery shortcodes. WordPress Media Library images (and NextGEN Gallery in the Pro version) are resized according to their intended consumer (Facebook, Twitter, Pinterest, etc). The Pro version detects embedded videos from Facebook, Slideshare, Vimeo, Wistia, and Youtube (including preview image, video title, and video description). WPSSO (Pro version) also includes support for NextGEN Gallery albums, galleries and images (shortcodes, image tags, album / gallery preview images, etc.).

Enhanced SEO

WPSSO Pro integrates with All in One SEO Pack, HeadSpace2 SEO, The SEO Framework, and Yoast SEO (aka WordPress SEO) — making sure your custom SEO settings are reflected in the Open Graph, Rich Pin, Schema Structured Data, and Twitter Card meta tags.

eCommerce Products

WPSSO Pro also supports Easy Digital Downloads, MarketPress – WordPress eCommerce, WooCommerce, and WP e-Commerce product pages, creating appropriate meta tags for Facebook Products and Pinterest Rich Pins, including variations and additional / custom images.

Forums and Social

WPSSO Pro supports bbPress, BuddyPress (see the BuddyPress Integration Notes), and rtMedia for WordPress, BuddyPress and bbPress, making sure your meta tags reflect the page content, including appropriate titles, descriptions, images, author information, etc.

Proven Performance

WPSSO is fast and coded for performance, making full use of all available caching techniques (persistent / non-persistent object and disk caching). WPSSO loads only the library files and object classes it needs, keeping it small, fast, and yet still able to support a wide range of 3rd party integration features. WPSSO requires PHP v5.3 or better, and is fully compatible with PHP v7.

Professional Support

WPSSO support and development is on-going. You can review the FAQ and Notes pages for additional setup information. If you have any suggestions or comments, post them to the WordPress support forum or the Pro version support website.

Follow Surnia Ulula on Google+, Facebook, and Twitter, and YouTube.

Additional Documentation


  • WPSSO can check the front-end webpage for duplicate meta tags, and includes a handy social preview feature.
  • WPSSO also includes a detailed list of the generated meta tags, for the more advanced or curious users.
  • WPSSO adds optional Schema type and social preview columns to the post, page, and custom post type lists (can be hidden/shown globally or per user).
  • WPSSO provides an Essential settings page for a quick and easy setup, along with more detailed and advanced settings pages.
  • WPSSO includes Author and Publisher social profile markup in your home page for Google Search and their Knowledge Graph.
  • WPSSO detects embedded videos in your content and creates video meta tags for Twitter, Facebook, and Google (Pro version required).
  • WPSSO integrates with several e-Commerce plugins to provide product details for Pinterest, Google, and others (Pro version required).


Installation Instructions

Install and Uninstall

Plugin Setup

Frequently Asked Questions


would get 5 stars if there was a package deal

The plugin is great. but there needs to be a package option. as a small business owner the core plugin isnt worth anything. I think a fair price would be $100 for all the addons to the core plugin.

I’m not 100% sure i will buy for other sites I manage based on that reason.

Best Social Meta Plugin!

I have tried others, and this is the best. It is worth the Pro version, for sure. It is well supported. It is expansive, so it takes some initial set-up, but it works GREAT!

Must have

Tried the plugin this morning.

Bought the Pro version this afternoon.

Good instructions on how to upgrade.

Works flawlessly with THE SEO Framework.

Good job!

Read all 105 reviews

Contributors & Developers

“WPSSO – Advanced Plugin for Social Meta Tags / SEO, Schema Markup and Knowledge Graph” is open source software. The following people have contributed to this plugin.


“WPSSO – Advanced Plugin for Social Meta Tags / SEO, Schema Markup and Knowledge Graph” has been translated into these 2 locales: French, French (Canada). Thank you to the translators for their contributions.

Translate “WPSSO – Advanced Plugin for Social Meta Tags / SEO, Schema Markup and Knowledge Graph” into your language.

Interested in development?

Browse the code or subscribe to the development log by RSS.


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.

Free / Standard Version Repository

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).

Changelog / Release Notes

Version 3.45.4 (2017/07/23)

  • New Features
    • None
  • Improvements
    • Added a new “Bitly Custom Short Domain” option (Pro version).
    • Added a warning if applying ‘the_content’ filter takes longer than 1 second.
  • Bugfixes
    • None
  • Developer Notes
    • Added more checks and debug info for possible image metadata inconsistencies from the WordPress Media Library.
    • Added a new WPSSO_CONTENT_FILTERS_MAX_TIME constant (default is 1.00 seconds).

Version 3.45.3 (2017/07/06)

  • New Features
    • None
  • Improvements
    • None
  • Bugfixes
    • None
  • Developer Notes
    • Cleaned-up some development / debugging error log messages.

Version 3.45.2 (2017/07/05)

  • New Features
    • None
  • Improvements
    • None
  • Bugfixes
    • Removed pass-by-reference from WpssoSchema::get_schema_types_array() to avoid corrupting the schema array cache.
  • Developer Notes
    • None

Version 3.45.1 (2017/07/03)

  • New Features
    • None
  • Improvements
    • Updated the Twitter Large Image Summary image size to 600×315 cropped.
    • Updated the Polylang plugin check to use a class name instead of the plugin slug for compatibility with Polylang Pro.
    • Added the Open Graph image width as a parameter to the Wistia video API URL.
    • Added the following types to the list of available Schema types.
      • https://schema.org/ClaimReview
      • https://schema.org/IndividualProduct
      • https://schema.org/Question
      • https://health-lifesci.schema.org/MedicalBusiness
        • https://health-lifesci.schema.org/CommunityHealth
        • https://health-lifesci.schema.org/Dentist
        • https://health-lifesci.schema.org/Dermatology
        • https://health-lifesci.schema.org/DietNutrition
        • https://health-lifesci.schema.org/Emergency
        • https://health-lifesci.schema.org/Geriatric
        • https://health-lifesci.schema.org/Gynecologic
        • https://health-lifesci.schema.org/MedicalClinic
        • https://health-lifesci.schema.org/Midwifery
        • https://health-lifesci.schema.org/Nursing
        • https://health-lifesci.schema.org/Obstetric
        • https://health-lifesci.schema.org/Oncologic
        • https://health-lifesci.schema.org/Optician
        • https://health-lifesci.schema.org/Optometric
        • https://health-lifesci.schema.org/Otolaryngologic
        • https://health-lifesci.schema.org/Pediatric
        • https://health-lifesci.schema.org/Pharmacy
        • https://health-lifesci.schema.org/Physician
        • https://health-lifesci.schema.org/Physiotherapy
        • https://health-lifesci.schema.org/PlasticSurgery
        • https://health-lifesci.schema.org/Podiatric
        • https://health-lifesci.schema.org/PrimaryCare
        • https://health-lifesci.schema.org/Psychiatric
        • https://health-lifesci.schema.org/PublicHealth
      • https://schema.org/ProductModel
      • https://schema.org/SomeProducts
  • Bugfixes
    • Fixed a missing Open Graph type filter for WP e-Commerce product pages.
    • Fixed parsing of the HTML returned by the Wistia video API.
  • Developer Notes
    • Renamed the following filters:
      • ‘wpsso_json_add_https_schema_org_collectionpage_parts’ to ‘wpsso_json_add_https_schema_org_collectionpage_mentions’
      • ‘wpsso_json_add_https_schema_org_searchresultspage_parts’ to ‘wpsso_json_add_https_schema_org_searchresultspage_mentions’
      • ‘wpsso_json_add_https_schema_org_profilepage_parts’ to ‘wpsso_json_add_https_schema_org_profilepage_mentions’
      • ‘wpsso_json_add_https_schema_org_blog_parts’ to ‘wpsso_json_add_https_schema_org_blog_blogpost’
    • Added https://health-lifesci.schema.org/MedicalSpecialty sub-types to the WpssoConfig::$cf[‘head’][‘schema_type’] array for future use.

Version 3.45.0 (2017/06/21)

  • New Features
    • None
  • Improvements
    • Localized the “Organization Logo URL” and “Organization Banner URL” option values.
  • Bugfixes
    • None
  • Developer Notes
    • None

Version 3.44.5 (2017/06/15)

  • New Features
    • None
  • Improvements
    • None
  • Bugfixes
    • Fixed the missing location information when the publisher property is a Schema LocalBusiness.
  • Developer Notes
    • Added more debugging messages in the Schema Local Business filter.
    • Added a check for a Local Business type when adding an organization property.

Version 3.44.4 (2017/06/08)

  • New Features
    • None
  • Improvements
    • None
  • Bugfixes
    • Added a check to exclude non-numeric width, height, length, and weight values for WooCommerce products (Pro version).
  • Developer Notes
    • None

Version 3.44.3 (2017/06/06)

  • New Features
    • None
  • Improvements
    • None
  • Bugfixes
    • Added a (now optional) second argument to get_term() for WP versions older than 4.4.
    • Replaced strpos() by filter_var() when checking for URLs in Schema property values to avoid false positives.
    • Added a default value when PHP_INT_MIN is not defined (available since PHP v7).
  • Developer Notes
    • None

Version 3.44.2 (2017/05/30)

  • New Features
    • None
  • Improvements
    • Added license information bellow the Authentication ID on the Pro Licenses settings page (Pro version).
    • Added a dismissable notice message to politely ask for a plugin rating on wordpress.org after one week.
  • Bugfixes
    • None
  • Developer Notes
    • None

Version 3.44.1 (2017/05/25)

  • New Features
    • None
  • Improvements
    • None
  • Bugfixes
    • Fixed HTML detection when passed as an argument to parse head meta tags for the duplicate meta tag check.
  • Developer Notes
    • None

Version 3.44.0 (2017/05/19)

  • New Features
    • Added three new options for Pinterest in the General settings page:
      • Add Hidden Image for Pin It Button
      • Add “nopin” to Header Image Tag (since WP v4.4)
      • Add “nopin” to Media Lib Images
  • Improvements
    • The Pinterest custom image in the Social Settings has been moved to the Structured Data / Schema Markup / Pinterest custom image.
    • Added a warning if retrieving the HTML document for the duplicate meta tag check feature takes longer than 3 seconds.
  • Bugfixes
    • None
  • Developer Notes
    • Added extra sanity checks to make sure that “meta itemprop content” tags with URL values are added as “link itemprop href” instead.

Version 3.43.3 (2017/05/15)

  • New Features
    • None
  • Improvements
    • None
  • Bugfixes
    • Fixed an incorrect variable name in the WooCommerce integration module (Pro version).
  • Developer Notes
    • None

Version 3.43.2 (2017/05/14)

  • New Features
    • None
  • Improvements
    • None
  • Bugfixes
    • None
  • Developer Notes
    • Updated the SucomForm image selection / upload methods to support numeric multi-option names.
    • Added an extra check for a non-variation product type when reading product variations for WooCommerce (Pro version).

Version 3.43.1 (2017/05/11)

  • New Features
    • None
  • Improvements
    • Added removal of HTML tags from the author / user description value in the Schema Person markup.
    • Added new social business account URLs for Google’s Knowledge Graph:
      • SoundCloud Business URL
      • Tumblr Business Page URL
      • YouTube Business Channel URL
  • Bugfixes
    • None
  • Developer Notes
    • None

Version 3.43.0 (2017/05/07)

  • New Features
    • Added a Gravity Forms + GravityView integration module with support for Single Entry view URL, title, description, and post image (Pro version).
  • Improvements
    • Added Facebook AppLink meta tags for YouTube and Vimeo videos:
      • al:ios:app_name
      • al:ios:app_store_id
      • al:ios:url
      • al:android:app_name
      • al:android:package
      • al:android:url
      • al:web:url
      • al:web:should_fallback
    • Added Twitter card meta tags for YouTube and Vimeo videos:
      • twitter:app:name:iphone
      • twitter:app:id:iphone
      • twitter:app:url:iphone
      • twitter:app:name:ipad
      • twitter:app:id:ipad
      • twitter:app:url:ipad
      • twitter:app:name:googleplay
      • twitter:app:id:googleplay
      • twitter:app:url:googleplay
    • Added out of stock variations for WooCommerce products in the Schema Product markup (Pro version)
  • Bugfixes
    • Replaced checks for Yoast SEO plugin slug by a function name check (to include Yoast SEO Premium).
  • Developer Notes
    • None

Version 3.42.0 (2017/04/30)

  • New Features
    • None
  • Improvements
    • None
  • Bugfixes
    • Fixed inheritance of Schema sub-types when adding Organization markup.
    • Fixed check of variable product for WooCommerce v3.x (Pro version).
  • Developer Notes
    • Code refactoring to rename the $is_avail array to $avail.
    • Replaced WPSSO_VARY_USER_AGENT_DISABLE constant checks by $avail array checks.
    • Added a Schema type inheritance feature when adding markup for single Schema elements.
    • Renamed the “WP / Theme Integration” tab in the Advanced settings to “Integration”.
    • Moved the WPSSO_BP_MEMBER_BIOGRAPHICAL_FIELD constant value to a new “BuddyPress Member Bio Field Name” option in the Advanced settings page.

Version 3.41.0 (2017/04/22)

  • New Features
    • Added a new “Plugin Dashboard” settings page.
  • Improvements
    • Moved all sidebar metaboxes (Help and Support, Version Information, etc.) to the new “Plugin Dashboard” settings page.
    • Added a WpssoHead vary_user_agent_check() method to handle user agents with special needs like the Pinterest crawler.
    • Improved the responsive styling of metaboxes for smaller displays.
  • Bugfixes
    • Fixed a null value for the default publisher ID in Schema WebPage and BlogPosting markup.
  • Developer Notes
    • Moved the validate button informational text from the WpssoMeta class to the WpssoMessages class.
    • Renamed all Pinterest option key prefixes from ‘rp’ to ‘p’ to reflect the Pinterest meta tag prefix value.
    • Renamed the SucomUtil crawler_name() method to get_crawler_name().
    • Added a new optional WPSSO_VARY_USER_AGENT_DISABLE constant.