Setup Guide for WPSSO Core

Taking the time to read this guide and review the SSO > Essential Settings page will help improve 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 below 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. You can enter all your business social account information in the SSO > Social Pages settings page. The social account URLs are used for meta tags and Schema Organization markup (which may appear in Google Search results to highlight your business 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 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 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.

Keep an Eye on Notifications

WPSSO Core attempts 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 - it will be grey with a 0 notification count by default. 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 directly 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 Schema vocabulary consists of over 700 types and 1400 properties. The Schema vocabulary can be used with many different encodings, including HTML meta tags, RDFa, Microdata, and JSON-LD. WPSSO Core adds Schema markup to webpages using the latest (and preferred) JSON-LD encoding format 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, and limited Schema types for some property relations. 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 standard).

If your theme templates include incomplete or incorrect RDFa / Microdata markup (a common problem), you should enable the WPSSO Strip Schema Microdata add-on to remove the incomplete or incorrect Microdata markup. Schema markup provided by WPSSO Core will include a '#sso/' value in the Schema "@id" property, making it easy to tell which Schema JSON-LD markup is provided by WPSSO Core, and which is not.

Validation Tools

Submit the home page URL, along with a post, page, and archive page URL 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.

Submit a few post and page URLs 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). 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 and/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.

Submit the home page URL, along with a post, page, and archive page URL to the Google Rich Results Test Tool or the Schema Markup Validator. If any information is missing from the Schema markup, use the Document SSO metabox in the WordPress editing page to complete the missing information.


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 "Social 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 the "Validators" tab allows you to submit the current webpage URL to several test and validation tools (mentioned above).

Documentation and Resources

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 plugin does not provide sufficient Schema JSON-LD markup for Google Rich Results.

The WPSSO Core Premium plugin reads WooCommerce product data and provides complete Schema Product JSON-LD 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.

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