Can I add custom Schema properties to the JSON-LD?

The Social and Search Optimization metabox allows you to customize several Schema property values based on the Schema Type you choose, but if you need to include additional properties, you can use the shortcode to manage the value of each property individually. Remember to submit the webpage URL to the Google Structured Data Testing Tool to validate your customized Schema property values.

How can I add Schema Aggregate Rating values?

There are several ways to add aggregate rating markup to your content, but first, let’s talk about what an “aggregate rating” actually is. ;-) The Schema.org website defines the Schema aggregateRating property value as: The overall rating, based on a collection of reviews or ratings, of the item. Two things to keep in mind about this: An aggregate rating value is calculated from several customer ratings / reviews for the current webpage content (e-commerce product reviews, for example). Google prefers — and often double-checks — that Schema markup reflects the current content of the webpage. So, if you want to manually set aggregate rating and/or review values in your Schema markup, make sure these customer ratings and/or reviews also appear in your webpage content (ie. the ratings and reviews are visible). So what’s the best and easiest way? The very best (and easiest) way is to use a supported plugin that offers rating and review features, like the WPSSO Ratings and Reviews add-on. The WPSSO RAR add-on extends the WordPress comment system with optional rating and review features, and does not conflict with WooCommerce’s own product rating features. ;-) Note that if you’re using the WPSSO Core Pro plugin, ratings and reviews from WooCommerce, Yotpo Social Reviews for WooCommerce, and WP-PostRatings are also supported. Alternatively, if you’re using a non-supported plugin — that saves aggregate rating values in post meta — you can use a WPSSO Core custom filter to add the Schema aggregateRating markup. Note that if you’re using the WPSSO JSON Pro add-on, you can also hook the Schema aggregateRating property directly. Either filter will work fine — it just depends on your personal preference. ;-) If none of the above solutions work for you, the WPSSO Schema JSON-LD Markup add-on also offers a [schema] shortcode that you can use to customize the current webpage Schema properties. The schema shortcode documentation includes a practical example on how to add custom aggregate rating values to your content.

Why shouldn’t I upload small images to the Media library?

Once in a while a customer will ask me this question — believing they should upload the image size they require for their content to the WordPress Media Library. For example, if they require a 300x200px image for their content, then they upload a 300x200px image to the Media library. What they don’t realize is that WordPress isn’t meant to be used this way, and they’re actually breaking an essential WordPress feature by doing this — not to mention that WPSSO will probably reject the image for being too small for Facebook Open Graph meta tags and Google Schema markup requirements. :-) WordPress and several 3rd party plugins provide different image sizes based on the resolution of the viewing device (aka responsive images). For example, a 300x200px image in your content will look blurry on high resolution screens (almost all current mobile phones, tablets, and laptops) because the browser must “upscale” the image to 450x300px or 600x400px in order to fill a 300x200px space on these high resolution screens. WordPress includes additional image markup in the webpage to provide alternative sizes (300x200px, 450x300px, and 600x400px for example), which allows the browser to choose the appropriate image based on the screen resolution. If you upload a 300x200px image to the Media library, WordPress will not be able to offer these additional image sizes, and WPSSO will not be able to use this image for most social sites and search engines (which have minimum image size requirements). So, what should you do if you want a 300x200px image in your content? That’s what WordPress image sizes are for. ;-) In the WordPress Settings > Media page, you can define sizes for a variety of different image sizes, like thumbnail, medium, medium-large, large, etc. Your theme and other plugins may also define additional image sizes, and some plugins allow you to define custom sizes as well. When you need to add an image to your content, you select an image from the Media library and choose the image size you require. You should never use the full size image in your content. If you need a 300x200px image, for example, you should have defined a 300x200px image size in the WordPress settings (cropped or uncropped, depending on your requirements) and then select that image size. So, what image size should you upload to the Media library? That’s easy — the largest size you can. ;-) Currently, Facebook uses 600x315px images for shared links, which means providing Facebook with 1200x630px images for high resolution devices. So at a minimum, you should be uploading 1200px wide images, but hopefully even larger to future proof your images for evolving requirements — both Facebook and Google may require larger images in the near future. Because so many websites have used small images in the past, WPSSO provides 600x315px images to Facebook by default. If your images are large enough, you should change this to 1200x630px in the WordPress Settings > Social and Search Image Dimensions page. See the WPSSO Setup Guide for more information on image sizes. ;-)

How do I fix Google Structured Data > hatom errors?

If you’re seeing errors in the Google Search Console for Structured Data > hatom (markup: microformats.org) for missing “author / entry-title / updated” values – these errors are not from meta tags or Schema markup. There have been several markup formats supported by Google over the years, and your theme templates may include older (and incomplete) hatom / microformats markup. You should contact your theme author to have them fix or remove the incomplete hatom / microformats markup, or try and Remove / Fix ‘hentry’ Errors in your Theme Templates yourself, using a WordPress filter (provided your theme templates use standard WordPress filters).

Can I add custom Schema properties to the JSON-LD?

The Social and Search Optimization metabox allows you to customize several Schema property values based on the Schema Type you choose, but if you need to include additional properties, you can use the shortcode to manage the value of each property individually. Remember to submit the webpage URL to the Google Structured Data Testing Tool to validate your customized Schema property values.

How does WPSSO Core find / detect / select videos?

Provided you are using the WPSSO Core Pro version (video detection modules are not included in the WPSSO Core Free version), videos from SlideShare, Vimeo, Wistia, and YouTube will be detected automatically from the following locations: A video entered in a theme or plugin custom field defined under the SSO > Advanced > Custom Meta > “Video Embed HTML Custom Field” or “Video URL Custom Field” options. A video entered in the custom Social and Search Optimization metabox “Video Embed HTML” or “Video URL” options. Embedded video HTML in your post / page content text or from a shortcode in your content text. WPSSO Core does not consider simple URL links to videos to be an important / integral part of your content (like an embedded video). If you’d like WPSSO Core to consider video links as equal to embedded videos, you must use a custom WPSSO Core content filter like this one.

How can I fix a PHP fatal “out of memory” error?

If your PHP configuration is limited to less than 128mb of memory, you may get a PHP fatal “out of memory” error when WordPress attempts to resize an image, etc. 32mb and 64mb memory limits were common a few years back, and some hosting providers have not revised their PHP configurations since then — which can cause problems with the latest versions of WordPress and some common plugins. Increasing the WordPress Memory Limit. Edit your wp-config.php file and enter something like: See Increasing memory allocated to PHP in the WordPress codex for more info. If you have access to your PHP.ini file, change the line in PHP.ini: If you don’t have access to PHP.ini try adding this to an .htaccess file:

WPSSO – Extend The Events Calendar Schema

WPSSO version 3.33.1-1 has been released, along with updates for the WPSSO JSON, WPSSO ORG, and WPSSO PLM extensions.

One of the big features for this new release is the added support for the Schema http://schema.org/Event type and its sub-types (DanceEvent, MusicEvent, etc.), along with integration of The Events Calendar plugin. The Events Calendar plugin already includes basic JSON-LD support, but the WPSSO Organization Markup (WPSSO ORG) and WPSSO Place / Location and Local Business Meta (WPSSO PLM) extensions allow you to include much more detail about the organizer (as an actual Organization instead of a Person), select a performer for the event, along with WPSSO’s standard support for images, videos, etc. The combination of WPSSO Pro and all three Pro extensions can provide extensive Schema markup about your event — see the following Schema JSON-LD markup for an example.


<script type="application/ld+json">{
    "@context": "http://schema.org",
    "@type": "DanceEvent",
    "url": "http://adm.surniaulula.com/event/an-example-event/",
    "name": "An Example Event",
    "description": "An excerpt for this example event.",
    "mainEntityOfPage": {
        "@context": "http://schema.org",
        "@type": "WebPage",
        "@id": "http://adm.surniaulula.com/event/an-example-event/"
    },
    "startDate": "2016-07-02T20:00:00+00:00",
    "endDate": "2016-07-02T22:00:00+00:00",
    "organizer": {
        "@context": "http://schema.org",
        "@type": "Organization",
        "url": "http://example-organizer-website.com",
        "name": "An Event Organizer",
        "alternateName": "An Alternate Organization Name",
        "description": "A description for this example organizer.",
        "logo": {
            "@context": "http://schema.org",
            "@type": "ImageObject",
            "url": "http://example-organizer-website.com/business-logo.jpg"
        },
        "location": {
            "@context": "http://schema.org",
            "@type": "EntertainmentBusiness",
            "name": "An Organizer Location",
            "address": {
                "@context": "http://schema.org",
                "@type": "PostalAddress",
                "streetAddress": "123 A Road",
                "addressLocality": "Some City",
                "addressRegion": "California",
                "postalCode": "123456789",
                "addressCountry": "US"
            },
            "geo": {
                "@context": "http://schema.org",
                "@type": "GeoCoordinates",
                "latitude": "32.7681037",
                "longitude": "-117.2517683"
            },
            "openingHoursSpecification": [
                {
                    "@context": "http://schema.org",
                    "@type": "OpeningHoursSpecification",
                    "dayOfWeek": "Sunday",
                    "validFrom": "2016-05-01",
                    "validThrough": "2016-08-31"
                },
                {
                    "@context": "http://schema.org",
                    "@type": "OpeningHoursSpecification",
                    "dayOfWeek": "Saturday",
                    "validFrom": "2016-05-01",
                    "validThrough": "2016-08-31"
                }
            ]
        }
    },
    "location": {
        "@context": "http://schema.org",
        "@type": "Place",
        "url": "http://adm.surniaulula.com/venue/an-example-venue/",
        "name": "An Example Venue",
        "description": "A description for this example venue.",
        "telephone": "123-456-7890",
        "address": {
            "@context": "http://schema.org",
            "@type": "PostalAddress",
            "streetAddress": "123 A Road",
            "addressLocality": "Some City",
            "addressRegion": "CA",
            "postalCode": "123456789",
            "addressCountry": "United States"
        },
        "geo": {
            "@context": "http://schema.org",
            "@type": "GeoCoordinates",
            "latitude": 0,
            "longitude": 0
        }
    },
    "offers": [
        {
            "@context": "http://schema.org",
            "@type": "Offer",
            "price": "20"
        }
    ],
    "performer": {
        "@context": "http://schema.org",
        "@type": "DanceGroup",
        "url": "http://example-dance-group.com",
        "name": "A Dance Group",
        "alternateName": "The Festival Dance Group",
        "description": "A description for this dance group.",
        "logo": {
            "@context": "http://schema.org",
            "@type": "ImageObject",
            "url": "http://example-dance-group.com/organization-logo.jpg"
        }
    },
    "inLanguage": "en_US",
    "image": [
        {
            "@context": "http://schema.org",
            "@type": "ImageObject",
            "url": "http://this-website.com/wp-content/uploads/an-image-800x800.jpg",
            "width": 800,
            "height": 800
        }
    ],
    "video": [
        {
            "@context": "http://schema.org",
            "@type": "VideoObject",
            "url": "https://www.youtube.com/v/taw1J6DZD9U?version=3&#038;autohide=1",
            "name": "Deva Premal",
            "description": "Example YouTube Video.",
            "fileFormat": "application/x-shockwave-flash",
            "width": "640",
            "height": "360",
            "uploadDate": "2012-02-17T00:00:00+00:00",
            "thumbnailUrl": "https://i.ytimg.com/vi/taw1J6DZD9U/hqdefault.jpg",
            "embedUrl": "https://www.youtube.com/embed/taw1J6DZD9U"
        },
        {
            "@context": "http://schema.org",
            "@type": "VideoObject",
            "url": "https://www.youtube.com/embed/taw1J6DZD9U",
            "name": "Deva Premal - Love is Space (Mantra)",
            "description": "Example YouTube Video",
            "fileFormat": "text/html",
            "width": "640",
            "height": "360",
            "uploadDate": "2012-02-17T00:00:00+00:00",
            "thumbnailUrl": "https://i.ytimg.com/vi/taw1J6DZD9U/hqdefault.jpg",
            "embedUrl": "https://www.youtube.com/embed/taw1J6DZD9U"
        }
    ]
}</script>

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

"@context": "http://schema.org",

"@type": "DanceEvent",

"url": "http://adm.surniaulula.com/event/an-example-event/",

"name": "An Example Event",

"description": "An excerpt for this example event.",

"mainEntityOfPage": {

"@context": "http://schema.org",

"@type": "WebPage",

"@id": "http://adm.surniaulula.com/event/an-example-event/"

"startDate": "2016-07-02T20:00:00+00:00",

"endDate": "2016-07-02T22:00:00+00:00",

"organizer": {

"@context": "http://schema.org",

"@type": "Organization",

"url": "http://example-organizer-website.com",

"name": "An Event Organizer",

"alternateName": "An Alternate Organization Name",

"description": "A description for this example organizer.",

"logo": {

"@context": "http://schema.org",

"@type": "ImageObject",

"url": "http://example-organizer-website.com/business-logo.jpg"

"location": {

"@context": "http://schema.org",

"@type": "EntertainmentBusiness",

"name": "An Organizer Location",

"address": {

"@context": "http://schema.org",

"@type": "PostalAddress",

"streetAddress": "123 A Road",

"addressLocality": "Some City",

"addressRegion": "California",

"postalCode": "123456789",

"addressCountry": "US"

"geo": {

"@context": "http://schema.org",

"@type": "GeoCoordinates",

"latitude": "32.7681037",

"longitude": "-117.2517683"

"openingHoursSpecification": [

{

"@context": "http://schema.org",

"@type": "OpeningHoursSpecification",

"dayOfWeek": "Sunday",

"validFrom": "2016-05-01",

"validThrough": "2016-08-31"

{

"@context": "http://schema.org",

"@type": "OpeningHoursSpecification",

"dayOfWeek": "Saturday",

"validFrom": "2016-05-01",

"validThrough": "2016-08-31"

}

]

}

"location": {

"@context": "http://schema.org",

"@type": "Place",

"url": "http://adm.surniaulula.com/venue/an-example-venue/",

"name": "An Example Venue",

"description": "A description for this example venue.",

"telephone": "123-456-7890",

"address": {

"@context": "http://schema.org",

"@type": "PostalAddress",

"streetAddress": "123 A Road",

"addressLocality": "Some City",

"addressRegion": "CA",

"postalCode": "123456789",

"addressCountry": "United States"

"geo": {

"@context": "http://schema.org",

"@type": "GeoCoordinates",

"latitude": 0,

"longitude": 0

}

"offers": [

{

"@context": "http://schema.org",

"@type": "Offer",

"price": "20"

}

"performer": {

"@context": "http://schema.org",

"@type": "DanceGroup",

"url": "http://example-dance-group.com",

"name": "A Dance Group",

"alternateName": "The Festival Dance Group",

"description": "A description for this dance group.",

"logo": {

"@context": "http://schema.org",

"@type": "ImageObject",

"url": "http://example-dance-group.com/organization-logo.jpg"

}

"inLanguage": "en_US",

"image": [

{

"@context": "http://schema.org",

"@type": "ImageObject",

"url": "http://this-website.com/wp-content/uploads/an-image-800x800.jpg",

"width": 800,

"height": 800

}

"video": [

{

"@context": "http://schema.org",

"@type": "VideoObject",

"url": "https://www.youtube.com/v/taw1J6DZD9U?version=3&autohide=1",

"name": "Deva Premal",

"description": "Example YouTube Video.",

"fileFormat": "application/x-shockwave-flash",

"width": "640",

"height": "360",

"uploadDate": "2012-02-17T00:00:00+00:00",

"thumbnailUrl": "https://i.ytimg.com/vi/taw1J6DZD9U/hqdefault.jpg",

"embedUrl": "https://www.youtube.com/embed/taw1J6DZD9U"

{

"@context": "http://schema.org",

"@type": "VideoObject",

"url": "https://www.youtube.com/embed/taw1J6DZD9U",

"name": "Deva Premal - Love is Space (Mantra)",

"description": "Example YouTube Video",

"fileFormat": "text/html",

"width": "640",

"height": "360",

"uploadDate": "2012-02-17T00:00:00+00:00",

"thumbnailUrl": "https://i.ytimg.com/vi/taw1J6DZD9U/hqdefault.jpg",

"embedUrl": "https://www.youtube.com/embed/taw1J6DZD9U"

}

]

}</script>