Setup Guide for WPSSO Core

Taking the time to read this guide and review the SSO > Essential Settings page will help your click-through rates and rankings in Google search results.

If you use the WooCommerce plugin, don't forget to check the Documentation and Resources section bellow for additional integration notes specific to WooCommerce.

Business Social Accounts (Optional)

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

Related information:

Author Social Accounts (Optional)

Ask your content authors to enter their Facebook and Twitter contact information in their WordPress user profile page. Each author's contact information can appear in various meta tags and Schema JSON-LD markup for Facebook, Twitter, and Google, but only if they complete their user profile.

Review Essential Settings

Review the website description on the SSO > Essential Settings page and select a default 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 custom image, featured image, attached image, or an image 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. Messages from the default WordPress notication system 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 admin toolbar.

Look for the SSO notification icon in the admin toolbar - by default, it will be 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. WPSSO notifications are context sensitive - they relate to the content shown in the current webpage.

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 779 types and 1390 properties. 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 using meta tags for Pinterest and other social crawlers. The WPSSO Schema JSON-LD Markup add-on is required to provide additional markup using JSON-LD encoding for Google and other search engines.

Google Rich Results are a set of requirements for a small selection of Schema types, which includes specific images dimensions, a limited set of values for some Schema properties, limited Schema types for some property relations, and more. Google Rich Results require several layers of related markup (aka a multi-dimensional arrays) that must be expressed using JSON-LD in the webpage head section (preferred by Google), or with RDFa / Microdata markup in theme templates (deprecated standards).

If your theme templates do not provide 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 also remove the incomplete or incorrect Microdata markup.

Not sure if your theme templates already provide markup for Google rich results? Submit a post or page URL from your website to the Google Rich Results Test Tool or the Google Structured Data Test 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. ;-)

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 or page to the Pinterest Rich Pins Validator. Note that the Pinterest validator recognizes only known Rich Pin types (article, recipe, product, etc.) - your home page and WordPress archive pages are generally not valid Rich Pin types. If you haven't already requested Rich Pin approval from Pinterest for your website, you can submit a request when validating your first example post or page.

If you have activated the WPSSO Schema JSON-LD Markup add-on, you can also submit URLs to the Google Rich Results Test Tool or the Google Structured Data Test Tool. WPSSO Core includes all the meta tags that social sites need, along with Schema markup for Google's Knowledge Graph in the site home page, but to create Schema markup for your post / page content, 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 a few index / archive webpages and post / page URLs to the W3C Markup Validator to verify the HTML of your theme templates. Social and search engine crawlers expect properly formatted HTML 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 HTML markup errors to your theme author.


Related information:

User 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 screen 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 to hide / view the "Schema" and "SSO Image" columns. You can also enable / disable these columns globally under the SSO > Advanced Settings > Interface tab.

When editing a post, page, category, tag, user profile, 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 selected (ie. Schema type or Open Graph type), 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 Schema markup created by the WPSSO Core plugin and its add-ons, and the "Validate" tab allows you to submit the current webpage URL to several test and validation tools (mentioned above).

Documentation and Resources

WPSSO Core is a powerful application and social framework that can read content, image, and video information from a variety of sources, including data from third-party plugins and services. It's worth noting the most common questions and issues bellow, along with their solutions:

Frequently Asked Questions

More Frequently Asked Questions...

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

BuddyPress Integration

BuddyPress was not originally created as a WordPress plugin, and consequently BuddyPress is not well integrated with WordPress features and functions. There are specific BuddyPress Integration Notes available to help you with some known BuddyPress integration issues.

WooCommerce Integration

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

Note that WooCommerce offers incomplete Schema markup for Google Rich Results by default. The WPSSO Core Premium plugin and its WPSSO Schema JSON-LD Markup add-on provide a solution by offering complete product meta tags for Facebook / Pinterest and complete 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, volume, weight, etc), product reviews, product ratings, sale start / end dates, sale prices, pre-tax prices, VAT prices, shipping rates, shipping times, and much, much more.