How can I modify Structured Data from WooCommerce products?

The plugin cannot modify any snippets created by WooCommerce. However you can completely deactivate the generation of snippets created from it. Then you can re-create the products snippet on your own. In version 2.2 the plugin has almost full WooCommerce support. So it might be that you get in trouble by creating snippets for variable products with multiple prices, for example.

Continue reading

Does the plugin work with PageBuilders?

Some of you asked if the plugin is compatible to page builders like Beaver Builder, Elementor or Divi Builder. Except of the Divi Builder and the Avada-Builder I’ve not tested the other ones. However the plugin should be compatible as it does not add anything to the builders itself. The Rich Snippets will appear on the frontend as a JavaScript, not visible to the end user but readable to search engines.

Maybe also interesting for you:

Fix missing logo URL error on publisher information

Sometimes you get an error from the Rich Snippets Test Tool by Google that says that the image URL is missing. If this is the case, you maybe did not define a Site Identity Logo in WordPress. So to fix this you can do one of the following (A or B):

Solution A:

  1. Login to your WordPress Dashboard.
  2. Go to Appearance > Customize.
  3. Click on “Site Identity”.
  4. Upload an image in the section where it says “Site icon”.

Solution B:

There are several reasons why you don’t have the “Site Identity” option:

  • You’re using an old WordPress version.
  • Your theme removed the setting from the customizer.
  • Or you don’t want to use the site icon image.

In this case, do the following to add an image manually:

  1. Login to your WordPress Dashboard.
  2. Go to “snip – The Rich Snippets Plugin” > Global Snippets.
  3. Edit the “Organization” Snippet.
  4. Scroll down to the http://schema.org/logo property.
  5. Then edit the three image-properties as shown in the image below by setting the dropdown from their original properties to “Direct text input”. Then enter:
    1. The image URL to the logo.
    2. The width of the image.
    3. The height of the image.

Rich Snippet for an Organization
Change these three properties if you want to edit the logo image manually

How to reference to something in the text editor

Referencing to content is outdated and will not work as of version 2.2.0! Referencing from JSON+LD format to HTML no longer works. The reference shortcode will be removed in version 2.2. Please read more on how to make the switch here.

Update July 30, 2018: There is currently a new schema type in development that would allow to reference something in the HTML sourcecode. It’s called CssSelectorType. However this type is currently in development and not supported by the major search engines. Once this is approved, the following information should work again as described.

Today I’ve got a question from Björn who works a lot with recipes on his website. He had a question about how to reference to some content in the editor. Here I describe how this works: Continue reading

When do snippets show up on search results?

Unfortunately there is still no statement from the big search engines if, how and when Rich Snippets show up on their search results. This makes it super difficult to give you an exact answer. Here are some notes that could help:

  • Snippets don’t show up after you’ve hit the save-button in the plugin. Search engines must crawl your site after you’ve added or changed your snippets on your website. If you add new posts on a daily basis the crawler will recognize changes faster then on other sites.
  • Verify that Google Rich Snippets Test tool does not show any errors on your sites where you’ve added rich snippets. If there are errors, please check if your snippet is correct. Note that orange warnings are not errors. Rich Snippets should show up if there are just warnings. However they will not if there are red errors. Read more about this in the linked article.
  • Nowadays search engines use artificial intelligence to personalize search results. So it can be that you do not see your snippets in search results whereas other users see it. Try to clear your browsers internal caches and cookies, log out of all services and try a new search to check if your snippet shows up.
  • If your snippet still does not show up, there might be other problems with your SEO quality. You should read trough Googles Webmaster Guidelines to get an idea of what might be wrong.
  • Also verify that you read through Googles Structured Data Reference for a Schema and if you followed guidelines.
  • Here is a very good blog post on SearchEngineJournal that explains why your rich snippets may not show up.

What is the hentry CSS class?

Before schema.org came out there was another possibility to add structured data to a website: microformats.com. The website offered a really simple way of adding structured data: CSS classes. So every single theme author was able to add structured data by just adding CSS classes to HTML-Elements. However in 2017 we have schema.org which is much wider supported by many search engines. And now we don’t longer need these microformats. Unfortunately some older (and even new) themes still add those microformat CSS classes. The plugin can try to remove some of them for you so that it does not confuse search engines when you use schema.org.

hentry

The hentry class is one of the so called “microformats” and it was used to show search engines where they can find the main content of a page.

vcard

However there were even more microformats like the “vcard” that was used like a (as the name suggests) business card and to tell search engines more about the people on the website (like the author).

Why should I surround my content with a DIV?

This information is outdated and no longer works. Update: July 30, 2018: There is currently a pending schema Type called CssSelectorType that would allow to use content from the current HTML page. However this is currently pending. Once this is approved the below information should work as described again.

A div-Element in HTML is just a section that has no layout. That means, surrounding your main content area will have no visual affect in most themes. However it allows to give the content an ID. For example if you wrote a post the sourcecode of the content could look like this:

No Div

<p>Praesent commodo cursus magna, vel scelerisque nisl consectetur et.</p>
<p>Maecenas sed diam eget risus varius blandit sit amet non magna. Nullam id dolor id nibh ultricies vehicula ut id elit.</p>

Here is what it looks like when surround it with a <div>-Element:

With DIV

<div><p>Praesent commodo cursus magna, vel scelerisque nisl consectetur et.</p>
<p>Maecenas sed diam eget risus varius blandit sit amet non magna. Nullam id dolor id nibh ultricies vehicula ut id elit.</p></div>

What the DIV-Element allows us is to give it an unique ID that we can refer to:

With DIV and ID

<div id="the_content"><p>Praesent commodo cursus magna, vel scelerisque nisl consectetur et.</p>
<p>Maecenas sed diam eget risus varius blandit sit amet non magna. Nullam id dolor id nibh ultricies vehicula ut id elit.</p></div>

With that ID it’s possible to refer to that content in a Rich Snippet.

Usage in a Rich Snippet

For example if you take a look at the Article-Snippet (that comes shipped with the plugin) you can find a property called http://schema.org/articleBody. This property usually inherits the content of a post. To avoid posting your complete content into this property we can instead refer to the main content in a post via the ID so that you don’t need to worry about changing it when the main post content gets changed.

Once the setting called “Surround main content with a DIV so that it can be addressed by snippets.” is active, you will see a new option called “Link to current post content” when you select the value for the property.

Property selection in the rich snippet plugin
Refer to the content via its ID.

How to add a Rich Snippet to a blog post

There is a completely now Structured Data Training Course that you can take for free!

Please watch the videos from the training linked above. The video below may show outdated pictures!

German / Deutsch

Mein Structured Data Training Kurs ist nun online. Er zeigt auf, was struktuierte Daten sind und wie SNIP funktioniert. Der Kurs ist derzeit allerdings nur auf englisch erhältlich.

Bitte beachte die Videos im Training, welcher oben verlinkt ist. Unten stehendes Video könnte veraltete Inhalte zeigen.