Pillar guide Structured data · 1 of 8
Structured Data for SEO: What It Is and How to Use It
Learn structured data for SEO: choose schema types, check existing markup, add JSON-LD, and validate your published pages with a practical checklist.
Key takeaways
- Choose markup that describes the page’s actual content.
- Check existing output before adding another generator.
- Validate the public URL and keep the data current.
- DEX page quality review complements dedicated schema tests.
Structured data for SEO describes a page in a format that search engines can read. For a blog article, it can identify the headline, author, images, and dates. Start by checking what your site already outputs, choose markup that fits the page, and test the published result.
You do not need to add every schema type you can find. You need accurate information, a clear owner for the implementation, and a way to keep it in sync with the page. More code does not make an article more useful.
This guide explains the terms, shows a blog example, and walks through choosing, adding, and checking markup. It also shows where page quality and SEO review with DEX fits into the process.
What Is Structured Data in SEO?
Structured data gives explicit labels to information about a page. Instead of leaving a tool to infer which name is the author, markup can describe that relationship. It complements the page people read.
Imagine a guide to choosing a desk lamp. The visible article has a title, a byline, an image, and publication details. Its markup can describe those facts. It should not claim that the guide is a product for sale just because it mentions lamps.
The distinction matters when choosing what to add. A buying guide, a product listing, and a business homepage can discuss the same topic but serve different purposes. Markup should reflect the actual page.
Structured data is not an alternative to writing a clear answer. If an article omits the facts readers need, adding labels will not fill that gap. Use the content audit guide to review the substance alongside its presentation.
What’s the Difference Between Structured Data, Schema.org, and JSON-LD?
These terms refer to different layers of the same task:
| Term | Meaning | Example |
|---|---|---|
| Structured data | Information organized with explicit labels and relationships. | Identifying a person as the author of an article. |
| Schema.org | A vocabulary of types and properties used to describe things. | BlogPosting, Person, and headline. |
| JSON-LD | A format for expressing linked data. | A block containing the article type and its properties. |
Schema.org gives you words for the description. JSON-LD is one way to write it. A rich result is a possible search presentation, rather than another name for either of them.
Google generally recommends JSON-LD when it fits the site’s setup. Microdata and RDFa are also supported formats. Choose a maintained implementation that meets the relevant feature rules; do not replace working markup only because a tutorial uses another format.
Schema.org defines a wider vocabulary than any one search feature supports. Check the search engine’s feature documentation when deciding eligibility. A type can be valid Schema.org markup without qualifying for a particular Google display.
How Does Structured Data Help Search Engines?
It provides a direct description of content and relationships. A search engine may use that information to understand a page and support eligible search features. The visible page remains the basis for what you describe.
Keep three questions separate: Can the markup be read? Does it meet a supported feature’s rules? Will that feature appear for a search? Passing the first two checks does not decide the third.
Google’s structured data guidelines explain that correct markup does not guarantee a rich result. Avoid treating a validation pass as a promise of impressions, clicks, or rankings.
Use this distinction in team discussions. “The code parses” is a narrow claim. “The public URL passes the relevant test” is stronger evidence about that version. Neither means that every searcher will see a special result.
The practical goal is a truthful description that can be maintained. It is easier to review a small set of accurate facts than a large block assembled from unsupported guesses.
Which Schema Types Should You Use?
Start with the page’s purpose. Select a type because it describes the content, rather than because another site uses it. Then read the current requirements for any search feature you want to support. Use the dedicated guide to build and test a breadcrumb trail. For the company behind the site, keep the business and publisher identity consistent. For individual writers, connect author profiles to their articles. For a product page, choose and test Product and Offer data using the rules for its search feature.
Article and BlogPosting for editorial content
BlogPosting is a type within the Article family. It suits a blog post when that is what the page contains. Check the Google Article documentation for supported properties and implementation guidance.
For an editorial team, the key source fields include the headline, author, relevant image, and dates. Check each against the published article. An internal draft owner is not automatically the public author.
BreadcrumbList for page hierarchy
Breadcrumb markup describes a path within the site. Plan that path around the site’s real organization. Use public destinations that make sense to a reader, and review the current Breadcrumb documentation before implementation.
Organization for the publisher or business
Organization describes the organization itself. It can be part of a site’s broader data model, while an article describes a particular piece of content. Keep identity and naming consistent across the site.
Do not create a new fictional publisher for every article. Agree on the organization’s details and let the supported template or integration use them consistently.
Types for specific page purposes
A genuine product page, local business page, or event page may need a different type and its own required information. Those implementations deserve separate checks. A generic blog post should not acquire prices, opening hours, or ratings it does not contain.
Use the current Google feature gallery to investigate supported search features. It is a selection aid, not a list of types to add to every page.
How Do You Check Whether Your Site Already Has Schema Markup?
Test an existing public page before installing or pasting anything. Your CMS, theme, plugin, or frontend may already generate markup from article fields. The editor screen alone may not show the final output. If several tools generate data, trace conflicting schema output before adding another source.
- Choose a representative public article and copy its exact URL.
- Use a structured data testing tool to see the types it detects.
- Compare its headline, author, dates, and URLs with the page.
- Identify which CMS setting, template, or integration generates each description.
- Record who owns that source before changing it.
More than one entity on a page is normal: a page can describe an article, its author, and its publisher. The concern is conflicting or unnecessary descriptions, such as two systems giving different authors for the same article.
If the output is wrong, correct the source. Adding another block with the right value may leave both versions live. Ask the developer or CMS owner to trace the template when the source is unclear.
This is especially important when the CMS and public frontend use different domains. Review the page visitors actually use. Our CMS publishing checklist covers that handoff.
What Does Article Structured Data Look Like?
The example below describes a fictional blog post. The author, dates, and image address are illustrative. It is a teaching example, not a ready-made description of your article. To apply this example to your posts, check Article and BlogPosting fields.
{
"@context": "https://schema.org",
"@type": "BlogPosting",
"headline": "How to Choose a Desk Lamp",
"author": {
"@type": "Person",
"name": "Alex Morgan",
"url": "https://example.com/authors/alex-morgan/"
},
"image": [
"https://example.com/images/desk-lamp-guide.jpg"
],
"datePublished": "2026-10-01T09:00:00-04:00",
"dateModified": "2026-10-15T10:00:00-04:00"
}
In an implementation using JSON-LD, the object goes inside a script element with the type application/ld+json. The displayed code here is escaped for reading; it is not a second live article entity on this guide.
- @context: identifies the vocabulary context.
- @type: says that the item is a blog post.
- headline: describes the article title.
- author: identifies the named writer and a page about them.
- image: points to an image representing the article.
- datePublished and dateModified: record its publication and real update times.
Use real public addresses instead of the example.com placeholders. Make sure the image is accessible and represents the article. Do not invent an author profile to fill a field.
The dates tell a story too. A meaningful update may change dateModified. Refreshing a timestamp without updating the article makes that story less trustworthy. Keep the visible information and generated data coherent.
This example covers a small set of fields. Check the current Article guidance for your implementation, and add other applicable properties only when you can supply accurate information. Do not treat a short tutorial example as a complete specification for every site.
How to Add Structured Data to Your Website
Choose the route that fits how the site is built. A managed CMS may provide settings. Another setup may rely on a plugin or a custom template. The important question is which system will keep the facts current.
1. Choose the page type and review its rules
Write down what the page does and which entity the markup describes. Open the relevant official documentation. Separate required properties from recommended ones, and check whether a targeted search feature applies to the page.
2. Gather accurate source information
Confirm the headline, byline, author page, image, and dates. Where the data belongs in CMS fields, store it there. A template should draw from an agreed source rather than several manually edited copies.
Review images as content too. An address that works in a developer’s browser may be private or temporary. Our image SEO guide explains the broader checks for useful visual content.
3. Use one coordinated implementation
Configure the supported CMS feature or have the developer map the fields in the template. For a custom site, treat the markup as part of the publishing system. Changes to article data should carry through to its public description.
Test with a representative page before extending the change to a whole template. Avoid switching on overlapping generators without reviewing their combined output.
4. Publish and inspect the output
Save the article, wait for the public update, and test the public URL. A draft can look correct while the live page still uses an older template or cached data. Keep the test record with the change.
For a small team, this can be one task with a clear owner: choose the type, map the facts, publish, and validate. There is no need to turn every article release into a manual code exercise when a maintained template can do the work.
How to Test and Validate Your Schema Markup
Use the right test for the question. Google’s structured data testing page links to the Rich Results Test and the Schema Markup Validator and explains their different scopes.
| Check | Question it helps answer |
|---|---|
| Schema Markup Validator | Does the page contain readable Schema.org markup, and what does it describe? |
| Rich Results Test | Which Google-supported rich result types does the test detect, and what issues does it report? |
| Public page review | Do the facts match what readers see? |
| Search Console inspection and relevant reports | What does Google report about the URL and supported features after publication? |
During development, testing a code sample can catch mistakes early. After release, test the URL as well. Confirm that the final page contains the expected data and that the crawler can access the needed resources.
Read the issue in context. A missing recommended value differs from a problem that prevents eligibility. Do not invent data just to make a warning disappear. Decide whether the information truly applies and correct the source when it does.
Keep a record of the tested URL, date, detected type, issue, correction, and owner. A screenshot of a pass without a URL or date is hard to use when the template changes later.
Why Isn’t Your Structured Data Showing a Rich Result?
A valid description does not force a search engine to display a particular feature. First check what you expected, which feature supports it, and whether the page meets its rules. Then investigate the public version. When a report names a specific issue, fix and validate Search Console schema issues rather than guessing why a feature is absent.
- Does the feature currently support this type of page?
- Does the markup match the main visible content?
- Are the needed properties accurate and accessible?
- Does the live output match the version you tested?
- Can the page be crawled and indexed as intended?
- Does Search Console report a relevant issue?
If access or index status is the problem, follow the crawling and indexing guide. Repeatedly adding schema does not remove a noindex instruction or repair a broken public URL.
If the checks pass, avoid escalating a normal display choice into endless edits. Document eligibility and monitor the relevant evidence. Do not promise a client that a test pass will produce a rich result for every query.
Common Structured Data Mistakes to Avoid
The most costly mistakes often start with a mismatch between the page and its data. An article labeled as a product, a rating that has no basis, or an author copied from another page can all create a misleading description.
Keep information current. A changed title with an old headline in the template makes review harder. A removed image that remains in the markup creates a broken reference. Treat those values as part of the same publication.
Do not confuse a larger block with a better implementation. Include meaningful relationships and accurate facts. Avoid adding unrelated types, fabricated reviews, or fields filled with keywords.
Finally, review combined output after changing tools. A new theme or integration may alter markup without an editor touching the article. Test the public page again instead of assuming the previous pass still applies.
How to Maintain Structured Data as Your Content Changes
Add a data check to the normal editing workflow. If the title, author, image, or publication details change, confirm the public description changes too. Give shared template issues to the person who can fix the source.
DEX offers page quality and SEO analysis even on its free plan. Use that review to keep the published page in view and organize the next improvement. Pair it with the dedicated schema tests for markup validation.
A general SEO score and a schema test answer different questions. Keep both records where the team can find them. Do not use a strong page quality score as evidence that a specific rich result is eligible.
DEX also reviews pages that have not gained positions after about 30 to 60 days. That broader review can prompt another look at content and its public presentation. A known markup error can be corrected sooner; it should not wait for that interval.
When reviewing outcomes, separate implementation evidence from traffic changes. Record when the markup changed and check relevant Search Console data where available. Demand, other edits, and search changes can affect results, so a rise in clicks alone does not prove schema caused it.
Structured Data SEO Checklist
- The chosen type fits the page’s actual purpose.
- Existing output was checked before adding another generator.
- The author, title, dates, images, and URLs are accurate.
- The description agrees with the visible content.
- The implementation has an owner and maintained source fields.
- The appropriate validator and feature test were used.
- The public URL was checked after release.
- Known issues and the next action were recorded.
- Templates are retested after changes.
Start with one important article and make its description reliable. Get started with DEX to connect page quality review with your wider SEO workflow, while using the official tools to check the markup itself.
FAQ
Does schema markup guarantee better rankings?
+
No. Use it to describe content accurately and support eligible search features. A validation pass is not a ranking promise.
Is JSON-LD required?
+
Google generally recommends it where suitable, but also supports Microdata and RDFa. Follow the rules for the feature you implement.
Can I add structured data without coding?
+
Some CMS setups provide settings or supported integrations. Check what your site already outputs and who maintains it before adding another tool.
Does every Schema.org type qualify for a Google rich result?
+
No. The vocabulary is broader than the search features Google supports. Check the current feature documentation.
Does structured data guarantee visibility in AI answers?
+
No. Do not treat markup or a successful test as proof that an AI system will cite or display the page.
Sources
- Introduction to structured data · Google