What Schema Markup is supported?

This plugin allows you to add every single schema markup found on schema.org. Here is a complete list that shows all markups on one page.

Plus: the plugin allows you to add schemas from the hosted extensions that are not officially part of the main syntax. You can find a complete list on this page.

Here is a complete list, of schema classes / schema types the plugin:

Does the plugin add content to each website page?

The answer to this questions (obviously) is yes as we have to output readable structured data so that search engines can read it.

However the data that is outputted is not visible to the end user. It’s only readable by search engines.

If you would view the sourcecode of one of your pages, you would find lines starting with something that looks like this:

<script data-snippet_id="snip-59a6a8000b284" type="application/ld+json">...</scrtip>

The data that can be found between these lines is the actual structured data that is formatted in JSON+LD format.

Can I create a star rating system with this plugin?

SNIP, the Structured Data Plugin for WordPress allows you to create Rich Snippets that produce stars in search results. However it does not allow your users to rate your blog post as it’s not a rating plugin. That means it has no built-in rating system that counts automatically.

Continue reading

What are Global Snippets?

Global Snippets are a beautiful thing. They allow you to add one rich snippet to many posts at once. But how does it work exactly?


How to create a global Rich Snippet

  1. When you activate the plugin you will see a new menu item under “snip” in your WordPress dashboard. It’s named “Global Snippets”.
  2. Just open it up and add a new Global Snippet.
  3. You will then be able to create a Rich Snipppets.
  4. When you’ve finished creating the snippet, you can choose where it should appear.
  5. For this scroll down to the “Position” metabox.
  6. There you can create a set of rules to determine which pages will use these schema.org syntax you’ve just created.

Are there any examples?

Yes there are!

If you have a fresh install:

  1. Go to “snip” in your WordPress dashboard and choose “Global Snippets”.
  2. A new admin notice will appear on top of the screen. It says “Hey Dude! The plugin can install some predefined global snippets for you!”.
  3. It also shows a button that says “Awesome! Install them please”.
  4. Click on this button.
  5. Here are your examples! 😉

If the snippets where installed previously and you want to create them again, do the following:

  1. Go to “snip” in your WordPress dashboard and choose “Settings”.
  2. Scroll down to the “Actions” part.
  3. Click the “Go for it” button where it says: “Reinstall predefined global snippets.”.
  4. You should then be redirected to the Global Snippets page and should see some new Global Snippets, like the “Article”.

How can I fill certain properties automatically?

Can I add another snippet to a post that has a global snippet?

Yes you can. Read more about this here: Can I use multiple snippets on one page?

How to tell search engines which of the snippets is the main snippet on a page

As you may know it’s possible to have multiple snippets on one page. However this may cause side effects. Especially if you’re using multiple snippets that can create a Rich Snippet on search results. Let’s say you have a blogpost that generates the following snippets:

  • WebPage
  • Review
  • Event

The Review- and the Event-Snippet can create a Rich Snippet on search results. But how do you tell search engines which one to show? Continue reading

Can I use multiple snippets on one page?

A new customer contacted me today and had a really good question. So I thought I can write a blogpost about it. The question was if it’s okay to have multiple snippets of the same type on one page. Here is the answer:

Continue reading

Can the plugin be updated automatically?

Not really automatically but kind of. You still have to initiate the update in your dashboard but you can get the update right in your WordPress dashboard without manually download/upload the plugin files.

If activated, you should get notified by Envato via E-Mail if I push a new version. However you can get a) get the updates earlier and b) via your own WordPress dashboard. Here is how to do it:

How to activate automatic updates

If the plugin is not yet running or is not activated:

  1. Log-In to your WordPress dashboard
  2. Activate the snip plugin.
  3. Go to snip -> Activation.
  4. Enter your purchase code and click the big blue button.
  5. That’s it!

What if updates do not appear?

The plugin only checks for updates every two days. If you know that there is an update but WordPress does not notify you about the update, do the following:

  1. Log-In to your WordPress dashboard
  2. Go to Dashboard -> Updates.
  3. If the update still does not show up, hit the gray “Check again” button.
  4. That forces the plugin to check live for an update.
  5. After that the update should appear.

I get an error that the domain is tied to another host.

This error occurs due to the fact that CodeCanyon only sells licenses that are available for one domain only. If you’re trying to install the plugin on multiple domains you will get the following error on the second domain:

“It seems that this purchase code is tied to another host. Please buy a new license in order to use this plugin on another sites.”

A) I’m getting the error while updating.

If you get the error while updating, please try the following:

  1. Login-in to your WordPress Dashboard
  2. Go to snip -> Settings.
  3. Click the “Clear Cache” button.
  4. Go to snip -> Activation.
  5. Click the big blue “Let’s get started” button again.
  6. If you get an error here, please read B).
  7. Then go back to Dashboard -> Updates.
  8. Click the gray “Check again” button.
  9. If you still get an error, please read B).

B) I’m not using it on other domains

If you think you’re not using the domain on another host, please contact support.

C) I want to switch to another domain

Of course that’s possible, too. Follow these steps:

C1) If you still have access to the old site

  1. Log-in to the site where SNIP was originally activated (old site)
  2. Go to “snip / Structured Data” menu and click the “Support” sub-menu item.
  3. On the right hand side you’ll find a metabox with a button labeled “Deactivate license on this site”. Press this button.
  4. The plugin will then de-activate and de-register itself.
  5. After this, you can use the purchase code on the new site.

C2) If you don’t have access to the old site

Please contact support.

Can I use Yoast SEO title and description?

Yes, with the beginning of version 2.2.0 you can use the following three internal values (if Yoast SEO plugin is installed):

  • SEO title
  • SEO meta description
  • and the Primary Category

Internal Yoast SEO values in dropdown menu
Choose one of the following values provided by the Yoast SEO plugin.

Does the plugin support custom fields?

In general, yes but there are limitations. Some of the plugins out there (like AdvancedCustomFields) save their data into the wp_postmeta database table. From there you can use the saved data to include it into your snippets.

In versions lower than 2.10.0 this only works if the data is stored in plain text only. All you have to do is to select “Post meta field” for the field type and enter the name of the field into the textarea. The plugin will then try to load that data from the wp_postmeta database table.

Post Meta Value for Snippets
Use the “Post meta field” value from the dropdown.

Since version 2.10.0 and up it’s also possible to target data that is stored as an array or an object. Read more on how to work with custom fields here.

How to set up a Rich Snippet for a WooCommerce Product

After the long post I wrote about Schema for WooCommerce, customers asked how it’s actually done. How can one build his or her own Rich Snippets? In an email a customer of mine, Michael, asked if I could do a blogpost or a video about how to set up SNIP, my Structured Data Plugin for WordPress to use it with WooCommerce products. I guess what he wanted to do is to produce a Rich Snippet for WooCommerce products so that search engines show a nice search result. But read on …

Continue reading

How to make global snippet properties overridable in each post

In version 2.2.0 of SNIP, the Rich Snippet WordPress Plugin, there is a cool new feature that allows you to overwrite global parameters directly in your posts.

If you’re new to SNIP, please take a look at the Structured Training Course. There are also two videos in the training that are related to Global Snippets:

Here is how it works in text format:

Continue reading

Does this plugin work with All In One WP Security?

Yes it does. However you need to deactivate the “Advanced Character String Filter” under WP-Security > Firewall > Additional Firewall Rules. Otherwise the plugin will prevent the Rich Snippet Plugin to load some important JavaScript files that it needs to load properly.

Advanced Character String Filter Setting
Deactivate this setting to make the Rich Snippet Plugin to work properly

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.

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.