WPSSO (Core Plugin)

The documentation for WPSSO is constantly evolving. If you’d like to see additional information on a subject or feature, please submit a new ticket.

Frequently Asked Questions
A list of Frequently Asked Questions for the WPSSO plugin for WordPress.
- Can I use the Pro version on multiple websites?
- Does LinkedIn read the Open Graph meta tags?
  LinkedIn reads the Open Graph meta tags for the title, description, url, and image.
- Doesn’t an SEO plugin cover that?
- How can I exclude / ignore certain parts of the content text?
- How can I fix a ERR_TOO_MANY_REDIRECTS error?
- How can I fix a PHP fatal “out of memory” error?
- How can I fix an “HTTP error” when uploading images?
  There are a number of reasons why you might get a generic "HTTP error" when uploading images in the WordPress Media Library.
- How can I have smaller dimensions for the default image?
- How can I see what the Facebook crawler sees?
- How can I share a single NextGEN Gallery image?
- How do I attach an image without showing it on the webpage?
- How do I fix my theme’s front page pagination?
  Some themes may have badly coded pagination filters, which break when WPSSO is activated.
- How do I install the WPSSO Pro version?
- How do I remove duplicate meta tags?
- How does WPSSO find / detect / select images?
- How does WPSSO find / detect / select videos?
- W3C says “there is no attribute ‘property’”
- What about Google Search and Google Plus?
- What features of NextGEN Gallery are supported?
- What is the difference between NGFB and WPSSO?
  The WPSSO plugin is a fork / child of NGFB — they have the same author, the same core features and code-base, but WPSSO is distributed without the sharing buttons and their related features.
- What is the difference between the Free and Pro versions?
- Why aren’t Pins from my website posting Rich?
- Why does Facebook play videos instead of linking them?
- Why does Facebook show the wrong image / text?
  The first time Facebook accesses your webpage, it will cache the image and text it finds. Facebook then prefers to use that cached information until it has expired or is refreshed manually.
- Why does Google Structured Data Testing Tool show errors?
  Google checks header HTML meta tags, along with Schema and Microdata HTML markup. What's the difference and why the errors?
- Why does WPSSO ignore some <img/> HTML tags?
- Why don’t my Twitter Cards show on Twitter?
  The WPSSO Pro version supports the Summary, Large Image Summary and Player Cards. The Twitter Card type is selected based on your content.
- Why is the Open Graph title the same for every webpage?
- Why is the page blank or its components misaligned?
  Some authors mistakenly assume that a WordPress filter will only be executed once for a post or content area. Here's how to disable WPSSO's use of certain filters.
Installation and Setup
Installation, setup, and removal instructions for the WPSSO plugin.
- A Setup Guide for WPSSO
  General tips on setting up and using the WPSSO plugin.
- Debugging and Problem Solving
- Developer Special – Buy one, Get one Free
  In the spirit of helping our fellow developers, we are offering a free WPSSO Pro license for every license purchased.
- How-To Migrate from NextGEN Facebook (NGFB) to WPSSO
  How to keep your settings when moving from NextGEN Facebook (NGFB) to WPSSO.
- Install the WPSSO Plugin (Free and Pro version)
  Installation instructions for the WPSSO plugin for WordPress (Free and Pro version).
- Integration Notes
  - BuddyPress Integration
    BuddyPress specific integration issues, and a few possible techniques to overcome them.
- Performance Tuning
  WPSSO is highly optimized, but you may still improve page load times by a few milliseconds by considering the following suggestions.
- Uninstall the WPSSO Plugin
  Uninstallation instructions for the WPSSO plugin for WordPress (Free and Pro version).
Other Notes
Other / additional documentation notes for the WPSSO plugin.
- About WPSSO Pro Integration Modules
  The following attempts to document a few of the integration modules included in the WPSSO Pro version.
  - Author Gravatar
    A summary of features provided by the WPSSO Pro integration module for the WordPress author Gravatar image.
  - Co-Author Plus
    A summary of features provided by the WPSSO Pro integration module for Co-Authors Plus, including example meta tags and JSON-LD markup.
  - Easy Digital Downloads
    A summary of features provided by the WPSSO Pro integration module for Easy Digital Downloads (EDD).
  - Facebook, Slideshare, Vimeo, Wistia, Youtube Video APIs
    An example showing the difference in meta tags between the Free version, which does not support video APIs, and the Pro version that does.
  - HeadSpace2 SEO
  - Polylang
    WPSSO (Pro version) includes a specific module for Polylang, allowing WPSSO retrieve accurate language information about the current and/or requested page.
  - The Events Calendar
  - WooCommerce
    A summary of features provided by the WPSSO Pro integration module for WooCommerce.
  - WordPress REST API v2
    The WPSSO WordPress REST API v2 module extends the returned /wp-json/wp/v2/posts (including custom post types), terms, and users JSON with a new 'head' array field consisting of 'html' and 'parts' arrays.
  - Yoast SEO (aka WordPress SEO)
    A summary of features provided by the WPSSO Pro integration module for Yoast SEO (aka WordPress SEO).
- Contact Information and Feeds
- Developer Resources
  WPSSO other / additional documentation notes for developers.
  - Constants
    A list of available PHP constants for the WPSSO plugin.
  - Filters
    Several filters are available within WPSSO to manipulate text (title, description, content, etc.) and array (tags, open graph, etc.) values.
    - Filter Examples
      WPSSO example filters to modify the topics list, sharing URL, keywords, tags, title, etc.
      - Add Schema aggregateRating Meta Tags
        If you would like to add product ratings from other sources, you can hook the 'wpsso_og' filter. Here's an example that retrieves the "average_review" and "count_review" custom fields (aka post meta).
      - Define a Custom Post Type (CPT) as a Product
        You can define additional custom post types (CPTs) as an Open Graph and Schema Product using this filter as an example.
      - Detect YouTube URL Links as Videos
        A custom filter for WPSSO to detect YouTube video URL links and "embedded" videos (in order to generate Open Graph video meta tags).
      - Modify the “article:tag” Keywords / Names
        How to modify, add, and/or remove tags from the article:tag and hashtag lists.
      - Modify the Default Article Topics List
      - Modify the Home Page Title for Facebook / Open Graph
        If you're using a index / archive type blog page, you can override the default title value with a custom filter like this one.
      - Modify the Sharing URL
        An example filter that sets the home page as the sharing URL for specific posts.
      - Read / Import Yoast SEO Social Meta
        If you've used Yoast SEO in the past, and would still like to read / import previously entered custom social meta for posts, terms, and users, you may add the following filters in your functions.php file.
      - Remove ‘hentry’ from Theme Templates
      - Return Taxonomy Terms for Custom Fields
        If you want to use term names instead of post meta for WPSSO custom option values, you can use the WordPress 'get_post_metadata' filter to provide those names to WPSSO as post meta.
      - Strip Additional Shortcodes
        You can customize the array of additional shortcodes to be removed by hooking the 'sucom_strip_shortcodes_preg' filter.
      - Use the REQUEST_URI for Post URLs
      - Working with Pre-defined Meta Tags and Custom Post Types
    - Filters by Category
      - Head Filters
        A list of WPSSO filters that are used to construct the head section of a webpage.
      - Media Filters
        Filters used to modify and return information about images and videos.
      - Open Graph Filters
        Filters used to modify and return the Open Graph array.
      - Twitter Card Filters
        Filters used to modify and return the Twitter Card array.
      - Webpage Filters
        Filters to modify and return information about the webpage (title, description, tags, etc.).
    - Filters by Name
      A complete list of filter hooks available to developers for the WPSSO plugin.
    - Other Filters
  - The $mod Variable
    The $mod variable is defined early in the WPSSO load process and is passed to most methods and filters.
- Inline Variables
  WPSSO offers several "inline variables" that can be included in the options used as meta tag values.
- Multisite / Network Support
- Working with Image Attachments
  A selection of plugins available to manage WordPress image attachments.