Advertisement
  1. SEJ
  2.  ⋅ 
  3. News

Introduction to Structured Data Markup

Easy explanation of Structured Data markup. Take the first steps to understanding structured data.

Image of a woman giving thumbs up with structured data projected behind her

The goal of this article is to introduce two parts of JSON-LD structured data, to show the logic behind how it is structured. This will help to build a foundation for understanding the rest of it. This article introduce two parts of structured data: The structured data Type and the Property.

Definition of Structured Data Markup

Structured data is written a coding language with logical structure to it. It’s called a Markup Language.

A markup language is computer code that is can be written, read and understood by humans. HTML is an example of a markup language.

Understanding the different parts of structured data markup takes the mystery out of it and helps you become better able to use it and not have to depend on others to help  you with it.

Structured data is easier than it looks!

Once you finish this article you will have a better understanding of structured data and can begin to understand the code.

You will also be better able to take advantage of the ranking opportunities that structured data offers.

In my previous article (What is Structured Data) I outlined the basics of structured data that explains what structured data is.

If you haven’t read that article yet, I encourage you to read it to get an understanding of what structured data is, who is responsible for it and how Google uses it for your benefit.

About JSON-LD Structured Data

JSON-LD is used to communicate Schema.org structured data. JSON-LD stands for JavaScript Object Notation for Linked Data.

There are others ways to communicate structured data but JSON-LD is Google’s preferred version. It’s easier to understand, too.

How Structured Data Markup is Organized

Structured data is basically information (data) that is presented in an organized manner (structured).
When you think about structured data, just remember that it’s nothing more complicated than information that is presented in an organized way.

Two Structured Data Terms You Need to Know

There are many technical terms used in Schema.org structured data. But there are two that are important to understand first because they are the basic building blocks of structured data.

Two fundamental terms to know are:

  • Types
  • Properties

A Schema.org structured data is about a (data) Type and can contain more than one Type within the JSON-LD structured data script.

Each Type has Properties that are associated with each Type.

What’s The Difference Between A Schema.org Structured Data Type And A Property?

The difference between a structured data Type and a Property is that the Type is the main subject of that part of the structured data and the Property is the description of that Type.

The structured data Type can be thought of as a thing and the property is a description of that thing.

References to Schema.org structured data property will always be in the context of it being an attribute of the Type.

So when you see the phrase Schema.org Structured Data Type, you can know that it’s the main topic of what that section of structured data is about. Likewise, the Type will always be accompanied by structured data Properties that offer details about that structured data Type.

Structured Data Type and Case

Image containing examples of structured data typesExample of structured data types

Taking a look at the above examples of structured data types, it’s evident that there is a capitalization structure to it.

The first letter of each word in a structured data type is capitalized.

That’s called PascalCase.

PascalCase is a way of naming things by using compound words (where two words are joined together) and capitalizing the first letter of each word.

So when you’re looking at a JSON-LD structured data script and you see something spelled in PascalCase (like NewsArticle), you can know that it is a structured data Type.

Examples of structured data types showing the PascalCase:

  • CreativeWork
  • Article
  • Blog
  • NewsArticle
  • Review
  • CriticReview
  • UserReview
  • Event
  • BusinessEvent
  • ChildrensEvent
  • MusicEvent

What is a Structured Data Property?

The definition of a structured data Property, according to Schema.org is:

“A property, used to indicate attributes and relationships of some Thing…”

When we talk about Type we are generally talking about a thing. That said, a service can be a type.

The way we describe a Type is by it’s attributes and relationships, which is called a Property.

Going back to the analogy of a person as a Type, we can describe a person by their attributes like the person’s educational status, job, address and so on.

In structured data, those “attributes” are called a structured data Property.

A property describes an attribute of a Type or a relationship of the Type with something else. The Property describes or gives information about the Type.

Structured Data Property and Case

Structured data Types are spelled with PascalCase. A structured data Property is spelled differently.

When the Property is a compound word (two words joined together) the first letter in the first word is lower case and the first letter in the second word is upper case.

This way of spelling compound words is called camelCase.

When the structured data Property is just one word, then the first letter of the word is still spelled in lower case.

Illustration showing PascalCase and camelCase in Structured Data

Illustration of how structured data type and structured data property are spelled with unique case styles

Here’s an example of a two-word compound Property:

articleBody

This is an example of a single-word Property:

image

Example of a JSON-LD Structured Data Script

Let’s take a look at an example of a News Article structured data script.

In the example below we see two items are types, using the code, “@type”:

The colon : is a part of the code and it means that everything that follows is what that Type is.

In the example, the first structured data Type is written like this:

"@type": "NewsArticle",

That script is saying, the following is a Type, indicated by the code @type and the colon next to it indicates that what follows is the structured data Type.

In this case, there are two Types, one is NewsArticle and the other is Organization.

Here’s the script:

<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "NewsArticle",
"url": "http://www.bbc.com/news/world-us-canada-39324587",
"publisher":{
"@type":"Organization",
"name":"BBC News",
"logo":"http://www.bbc.co.uk/news/special/2015/newsspec_10857/bbc_news_logo.png?cb=1"
},
"headline": "News of What Happened in Canada'",
"mainEntityOfPage": "http://www.bbc.com/news/world-us-canada-39324587",
"articleBody": "Survey indicates Canadians are fine where they are.",
"image":[
"http://example-1.bbci.co.uk/news/560/media/images/75306000/jpg/_75306515_line976.jpg",
"http://example-1.bbci.co.uk/news/560/cpsprodpb/12B64/production/_95244667_mediaitem95244666.jpg"
],
"datePublished":"2017-03-20T20:30:54+00:00"
}
</script>

In the above script you will see that there is a comma. That means that there is more data coming. It’s like a list where you say that there is this, this, this and that.

We’ll get into the commas and brackets in the next article. I just wanted to point that out to explain what it is.

Example of a structured data Type that consists of a single wordA structured data Type that consists of a single word has the first letter capitalized

A few lines down you’ll see that there’s another type that is labeled, Organization. The interesting thing about this Type is that it is a single word and the first letter is capitalized.

Even though it’s a single word and not a compound word (two words joined together), the first letter is still capitalized.

A structured data Property that consists of a single word will have the first letter in lower case.

Beneath the section where it says “@type”:”Organization” you’ll see that there is a property.

That property is a single word and the first letter of that word is spelled in lower case, like this: “name“:”BBC News”,

Let’s take a look at the script again, focusing on the section for the publisher property.

Here’s the section:

"publisher":{
"@type":"Organization",
"name":"BBC News",
"logo":"http://www.bbc.co.uk/news/special/2015/newsspec_10857/bbc_news_logo.png?cb=1"
},

Publisher (publisher) is a property of the NewsArticle type. So it’s spelled in lower case like this: publisher.

But the type of publisher is a Type, which is an Organization.

The Organization Type has a name and it’s the BBC News. The Organization also has a logo.

Understanding Structured Data Type and Property

If you have gotten this far you now know two important parts of a JSON-LD structured data and a little bit of how they are organized within the structured data script.

If you’d like to explore and learn more about structured data, you may be ready to review the different Schema.org types.

Here is a partial list of ten generic types called Parent Types. Each generic parent type can be clicked through to more specific types.

  1. Thing
  2. Action
  3. CreativeWork
  4. Event
  5. Intangible
  6. MedicalEntity
  7. Organization
  8. Person
  9. Place
  10. Product

At this time there are a total 841 Types, 1,369 Properties.

For example, the hierarchical order for the WebSite type is:

Thing > CreativeWork > WebSite

That means you can start at the Schema.org page for Thing here: https://schema.org/Thing

Then click through to the WebSite Type page here: https://schema.org/WebSite

On that page you can find examples of what that structured data can look like.

Additionally, you can download a Chrome extension called Schema Builder from Schema.dev and use that to build structured data by filling out a form.

By reviewing the Schema.org structured data and using the Schema Builder Chrome plugin you will be able to get a feel for the different kinds of structured data there are and begin understanding JSON-LD structured data.

The next article will go deeper into discussing the code used for structured data. After that you should have a significantly better understanding of structured data code.

Read More

What is Structured Data?

Category News SEO
ADVERTISEMENT
SEJ STAFF Roger Montti Owner - Martinibuster.com at Martinibuster.com

I have 25 years hands-on experience in SEO and have kept on  top of the evolution of search every step ...

Introduction to Structured Data Markup

Subscribe To Our Newsletter.

Conquer your day with daily search marketing news.