WooCommerce Integration Notes

WPSSO Core Premium integration with the WooCommerce plugin is extensive and handled automatically, but advanced users and developers may want to know about these additional customization features. ;-)

The following integration notes are for WPSSO Core Premium, which includes a WooCommerce integration module to fetch product information from the WooCommerce plugin. If you use the Free / Standard version of WPSSO Core, you will need to purchase the Premium version of WPSSO Core.

Note that the Schema markup offered by the WooCommerce plugin itself is incomplete and will not pass Google validation.

WPSSO Core Premium will add complete product meta tags for Facebook, Pinterest, and other social websites — if you also need better Schema JSON-LD markup for Google’s Rich Results, you should pair the WPSSO Core Premium plugin with its WPSSO JSON Premium add-on. Together, they provide extensive, complete, and correct Schema product markup for Google, including additional product images, product variations, product attributes (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 (see an example test product).

Additional WooCommerce Product Information

WPSSO Core Premium reads all available product information from WooCommerce automatically (prices, sku, sales, dimensions, variations, etc.), and can also read these additional WooCommerce product attributes if you create them in your WooCommerce store (note that upper / lower case is important).

  • Brand
  • Color
  • Condition (possible values: Damaged, New, Refurbished, or Used)
  • GTIN-14
  • GTIN-13 (aka UPC)
  • GTIN-12 (aka EAN)
  • GTIN-8
  • ISBN
  • Material
  • MPN (aka Manufacturer Part Number)
  • Size
  • Gender
  • Volume (in ml)

Please note the limited selection of product condition values (Damaged, New, Refurbished, or Used), which are determined by Google’s Rich Search markup standard — do not use other values.

When creating a WooCommerce product attribute, you can use it for product variations (ie. the WooCommerce “Used for variations” checkbox is selected), or not  — and if not, then its value will be used for the main product and inherited by variations. If you use the attribute for variations, then you can assign a default attribute value for all variations under the WooCommerce “Variations” tab, or not — and if not, then each variation is expected to have a unique value, like color, for example.

See the following WooCommerce documentation for information on managing product attributes and product variations:

If you use the WooCommerce Brands plugin, the “Product Brand Attribute Name” and the “Product Brand Custom Field” options in WPSSO Core Premium will be disabled (as the supported WooCommerce Brands plugin becomes the source of all product Brand information).

If you use the Product GTIN (EAN, UPC, ISBN) for WooCommerce plugin, the “Product GTIN Attribute Name” and the “Product GTIN Custom Field” options in WPSSO Core Premium will be disabled (as the supported Product GTIN (EAN, UPC, ISBN) for WooCommerce plugin becomes the source of all product GTIN information).

Google reports “missing a global identifier”?

If the Google Testing Tool reports that “This Product is missing a global identifier (e.g. isbn, mpn or gtin8)” for your WooCommerce products, note that the global identifier referred to by Google is not the Schema ‘productID’ property, but a general term used by Google for a missing globally common product identifier like the ‘mpn’ (aka Manufacturer Part Number) or another globally common product identifier (ISBN, GTIN, etc.).

Unfortunately, the often used product ‘sku’ (aka Stock Keeping Unit) is a number that changes from one retailer to another, so is not valid as a globally common product identifier.

If the Google Testing Tool reports a missing global identifier for your Schema Product markup, make sure you have created one or more WooCommerce product attributes for the MPN, ISBN, GTIN, etc.

Customize Product Attribute Names

You can customize the default product attribute names that WPSSO Core Premium reads from WooCommerce under the SSO > Advanced > Integration tab (click the “show these options” link if viewing the basic options list).

Modifying the defaults can be useful if you already have one or more existing WooCommerce product attributes with different names — for example, using the “Colour” attribute name instead of “Color”. ;-)

The SSO > Advanced > Integration tab, which includes optional e-commerce product attribute names.

What if you prefer custom fields?

It’s possible to use custom fields (aka WordPress post meta) instead of WooCommerce product attributes, but there are some downsides to doing this. Custom fields can only offer one value, and as such, can only be applied to simple product markup, not product variation markup. WooCommerce is also designed to manage products and product information — using the built-in features of WooCommerce makes more sense than using free-form / non-standard custom fields. If you’re certain that you want to use custom fields, instead of WooCommerce product attributes, you need to:

  1. Clear the desired Product Attribute Name under the SSO > Advanced > Integration tab (click the “show these options” link if viewing the basic options list).
  2. Enter the desired custom field name under the SSO > Advanced > Custom Meta tab (click the “show these options” link if viewing the basic options list).

What if you prefer manual entry in the Document SSO metabox?

Like custom fields (see above), manual / customized values in the Document SSO metabox can only offer one value, and as such, can only be applied to simple product markup, not product variation markup. If you’re certain that you want to use manual / customized values in the Document SSO metabox, instead of WooCommerce product attributes or custom fields, you need to:

  1. Clear the desired Product Attribute Name under the SSO > Advanced > Integration tab (click the “show these options” link if viewing the basic options list).

Product Prices with Value Added Tax (VAT)

WPSSO Core Premium provides WooCommerce product prices in meta tags and Schema markup without tax by default. If you prefer your meta tags and Schema markup to include product prices with VAT, you can define the following constant in your wp-config.php file: