Setup Guide

WPSSO Core and its complementary add-ons work great "right out of the box" - you can keep the default plugin settings as-is - but taking the time to review a few basic options can help maximize your social presence, Google ranking, and click-through rates. ;-)

If you use BuddyPress, WooCommerce, or WP eCommerce, don't forget to review the Documentation and Resources section below for additional integration notes. ;-)

Business Social Accounts (Optional)

If you haven't already done so, create a Facebook Page and Twitter account for your website / business. You can enter all your website / business social account information on the WordPress SSO > Social Pages settings page. The social account URLs are used by WPSSO Core for Open Graph, Schema, and other meta tag values - including the Organization social profiles in Schema JSON-LD markup (which may appear in Google Search results to highlight your website / business social pages).

Related information:

Author Social Accounts (Optional)

Ask your content authors to enter their Facebook and Twitter contact information on their WordPress user profile page. Each author's contact information can appear in various meta tag values and Schema JSON-LD markup, but only if they complete their user profile. All URLs found in the author's contact methods will be listed in the author social profile markup for Google.

Review Essential Settings

Review the site description on the SSO > Essential Settings page and select a default / fallback image ID or URL. The default image is used for index / archive pages, and as a fallback for posts and pages that do not have a suitable image featured, attached, or available in their content.

Do not forget to submit a few example posts / pages to the validation tools mentioned below. Some markup formats, like Pinterest Rich Pins, must be requested / enabled when submitting an example post / page to their validation tool.

Keep an Eye on Notifications

WPSSO Core and its complementary add-ons attempt to keep notifications to a minimum, issuing only informational, warning, or error notifications when required. The default WordPress notication messages can feel intrusive and over-used, and are not compatible with the new block editor in WordPress v5, so WPSSO Core includes its own (more discreet) notification system in the top toolbar.

Look for the SSO icon in the top toolbar - by default, it should remain grey with a "0" notification count. If there are notifications, the count will increase and the SSO icon be shown on a red, yellow, or blue background.

Schema Markup vs Google Rich Results

Schema (aka "") is a collaborative, community lead standard for structured data markup. Schema markup is classified by type, and each type is associated with a set of properties. The types are arranged in a hierarchy and the current Schema vocabulary consists of 816 types, 1307 properties, and 289 enumeration values. The Schema vocabulary can be used with many different encodings, including meta tags, RDFa, Microdata and JSON-LD. WPSSO Core adds Schema markup to webpages as meta tags for Pinterest and other social / search crawlers that can read Schema markup meta tags. The WPSSO Schema JSON-LD Markup add-on is required to provide complete Schema markup as JSON-LD for Google.

Google Rich Results are a set of minimum requirements for a small selection of Schema types, which includes specific images dimensions (example, a 600x60px organization banner "logo" image for article publishers), limited values for some properties (example, product conditions), specific Schema types for some property relations, etc. Google Rich Results require several layers of Schema markup (aka a multi-dimensional arrays) that must be expressed using JSON-LD (preferred by Google) in the webpage header or footer, or with RDFa / Microdata markup (deprecated standards) in theme templates.

If your theme templates do not include RDFa / Microdata markup for Google Rich Results, you should enable the WPSSO Schema JSON-LD Markup add-on. If your theme templates include incomplete or incorrect RDFa / Microdata markup (a common problem), you should enable both the WPSSO Schema JSON-LD Markup add-on and the WPSSO Strip Schema Microdata add-on to remove the incomplete or incorrect Microdata markup from your templates.

Not sure if your theme templates support Google Rich Results? Submit an example post / page URL from your site (not the home page) to the Google Structured Data Testing Tool, and compare the results before / after enabling the WPSSO Schema JSON-LD Markup add-on. Between checks, don't forget to clear the cache of any caching plugin or service you may be using, along with clearing the WPSSO cache in the SSO > Tools and Actions settings page. ;-)

Social and Search Image Sizes

Cropped or Uncropped?

The difference between cropped and uncropped image dimensions is important to understand. When resizing and cropping an image, it will be resized so that both sides meet or exceed the image dimensions required, and the excess width or height is trimmed. The resulting image will match the required dimensions exactly (having sacrificed parts of the image). When resizing without cropping, the original aspect ratio is preservedm and no parts of the image are sacrificed. The image will be resized so both the width and height fit within the designed size - so only oneside of the image has to match the required size.

Most social and search sites automatically crop images to fit within a specific size container - for example, Facebook shows link share images in a 600x315px container. By offering pre-cropped images of the correct size, site owners can control how images are cropped instead of letting social and search sites crop images automatically (and sometimes incorrectly).

Upscale / Enlarge Images?

WordPress does not upscale / enlarge images. WordPress can only create smaller images from larger full size originals. Upscaled images do not look as sharp or clear, and if enlarged too much, will look fuzzy and unappealing - not something you want to promote on social and search sites. WPSSO Core Premium includes an optional module that allows upscaling of WordPress Media Library images (up to a maximum upscale percentage). For example, a full size image of 100x200px could be upscaled up to 150x300px using a maximum of 50%, but resizing any larger would fail. If you feel strongly that upscaling small images is something you require (instead of uploading larger full size originals), you can enable the SSO > Advanced Settings> Integration > Upscale Media Library Images option.

Validation Tools

Submit a few sample posts, pages, etc. to the Facebook Sharing Debugger to verify your Open Graph meta tags. A link to the Facebook debugger is available under the Validate tab in the Document SSO metabox (on post, term, and user editing pages). Submitting a URL to the Facebook debugger can also be used to clear Facebook's cache (after clicking the "Fetch new scrape information" button). If you're validating older posts / pages, pre-dating the activation of WPSSO Core, note that Facebook may continue to use the old meta tag values from its cache, even after fetching the new scrape information.

Submit an example post / page to the Pinterest Rich Pins Validator. Note that the Pinterest validator recognizes known Rich Pin types only (article, recipe, product, etc.) - your home page and WordPress archive pages are generally not valid Rich Pin types. Pinterest Rich Pins are an extension of Open Graph and Schema meta tags, but the Rich Pins Validator can be a little buggy, so double check any errors with the Facebook debugger to make sure they are actual / real errors. If you haven't already requested / enabled Rich Pins support from Pinterest for your website, you can request Rich Pin support when validating an example Post / Page from your site (that uses a known Rich Pin type).

If you have activated the WPSSO Schema JSON-LD Markup add-on, you can also submit URLs to the Google Structured Data Testing Tool. WPSSO Core includes all the meta tags social sites need, along with Schema markup for Google's Knowledge Graph in the site home page. To express more complex Schema markup you must activate the WPSSO Schema JSON-LD Markup add-on. Some Schema types may also require additional organization and/or location information from the WPSSO Organization Markup add-on and/or WPSSO Place and Local SEO Markup add-on.

Submit index / archive and Post / Page URLs to the W3C Markup Validation Service to verify the HTML of your theme templates. Social and search engine crawlers expect properly coded HTML markup that conforms to current HTML / XHTML standards. If your webpages contain serious HTML markup errors, social and search crawlers may be unable to read your meta tags and Schema markup. You should report any template markup errors to your theme author.


Related information:

Interface and General Usage

On most WordPress admin pages you'll find a "Screen Options" drop-down tab on the upper right-hand side of the page. You can use these options to include / exclude specific metaboxes and columns from the current page. For example, when viewing the Posts or Pages list you can use the "Screen Options" drop-down tab to hide / view the "Schema" and "SSO Image" columns. You can also enable / disable these columns globally under the SSO > Advanced Settings> Editing Pages > Table Columns tab.

When editing a Post, Page, category, tag, etc., you'll find a Document SSO metabox below the content area where you can customize default texts, images and videos. The Document SSO metabox shows a different set of options based on the content type (aka Schema type or Open Graph type) selected, allowing you to customize the details of articles, events, e-Commerce products, recipes, reviews, and more. The "Preview" tab shows how this webpage might look when shared on Facebook, the "Head Markup" tab shows a complete list of meta tags and markup created by the WPSSO Core plugin and its add-ons, and the "Validate" tab allows you to submit the current webpage URL to a number of test and validation tools (mentioned above).

Documentation and Resources

WPSSO Core is a powerful tool and social framework that detects images and videos from a variety of sources (attached, featured, content, etc.), along with 3rd party plugins and e-commerce product information. It's worth noting some of the most common questions, to get an idea of what WPSSO Core can do, and some of the issues that may come up. Some of the most relevant / popular frequently asked questions are:

Frequently Asked Questions

Comments and suggestions to improve the plugin are always welcome — please open a ticket if you have any ideas you would like to share with us. ;-)

BuddyPress Integration

BuddyPress is not well integrated with the WordPress core functions, so there are specific BuddyPress Integration Notes available to help you overcome some BuddyPress limitations.

WooCommerce Integration

The WooCommerce Integration Notes are useful to include additional product information in meta tags and Schema markup, like the product brand, color, condition, material, size, etc.

The WooCommerce plugin is known to offer incomplete Schema markup for Google. The WPSSO Core Premium plugin and its WPSSO Schema JSON-LD Markup add-on provide a far better solution by offering complete Facebook / Pinterest Product meta tags and Schema Product markup for Google Rich Results — including additional product images, product variations, product information (brand, color, condition, EAN, dimensions, GTIN-8/12/13/14, ISBN, material, MPN, size, SKU, weight, etc), product reviews, product ratings, sale start / end dates, sale prices, pre-tax prices, VAT prices, and much, much more.

Developers and WebSite Designers

WordPress developers and website designers may want to consider a few additional settings...

  • If you know that your theme header templates do not include any social meta tags, and no other plugin is adding social meta tags to your webpages, then you could disable the "Check for Duplicate Meta Tags" option under the SSO > Advanced Settings> Integration tab.

  • If your theme uses custom fields to manage additional images, video URLs, embed video HTML, product details, etc., you can enter their custom field names under the SSO > Advanced Settings> Editing Pages > Custom Fields (Metadata) tab.

  • WPSSO Core adds the "link rel canonical", "meta name description", and "meta name robots" meta tags to webpage headers by default. All three of these meta tags are disabled automatically if an SEO plugin is detected, or you can enabled / disable them manually under the SSO > Advanced Settings> HTML Tags > SEO / Other tab.

  • WPSSO Core creates Schema WebSite, Organization, and Person social JSON-LD markup in the front page for Google's Knowledge Graph. If your theme does not include proper Schema markup for your post / page content (aka Microdata markup), you should consider enabling the WPSSO Schema JSON-LD Markup add-on, which can provide complete Schema JSON-LD / SEO markup for your content (Schema Article, Place, Product, etc.).