In today's highly competitive online environment, it is particularly important to enable search engines to better understand your website content so that it can stand out in search results.And JSON-LD structured data is the key tool to achieve this goal.AnQiCMS as an efficient and customizable enterprise-level content management system naturally also understands this, and provides the function of generating and customizing Json-LD structured data.But it's not enough to generate; how to ensure that these data are correctly parsed and effectively utilized by search engines has become a problem that website operators must pay attention to.

Today, let's delve into how to verify the validity of the Json-LD structured data generated by AnQiCMS or customized by you.

How to generate or customize Json-LD in AnQiCMS?

First, let's briefly review the support of AnQiCMS for Json-LD.According to AnQiCMS's documentation, when you enable the structured data feature in the background, the system will automatically insert the default Json-LD tags into the page. These tags contain the basic information of the website and help search engines initially understand the page.

However, for experienced operators, the default structured data may not fully meet personalized needs. AnQiCMS provides powerful customization capabilities, and you can use{% jsonLd %}Labels, freely write Json-LD code in the template.

For example, if you want to customize the author and image information for an article, you can do it like this:

{% jsonLd %}
<script type="application/ld+json">
{
	"author": "AnQiCMS",
	"image": [
		"https://en.anqicms.com/anqicms.png"
	]
}
</script>
{% endjsonLd %}

The cleverness of this custom tag lies in the fact that it allows you to directly write a JSON object that conforms to the JSON-LD syntax in the enclosed content.AnQiCMS will intelligently merge these custom data with the system default generated data.If your custom field conflicts with the default field, your custom value will override the default value, which provides you with great flexibility.

However, there is a crucial prerequisite: the fields you define must strictly comply with the syntax specifications of Json-LD and the Schema.org conventions.Once the syntax is incorrect, or the data structure does not conform to the standard, your efforts may be in vain.Therefore, verifying the validity of JSON-LD is an indispensable step after deploying structured data.

The importance of verifying the validity of JSON-LD structured data

Validating JSON-LD structured data is not only to avoid technical errors, but also to ensure that your website can fully utilize the SEO advantages brought by structured data. Effective Json-LD can help search engines:

  1. More accurately understand the content:Search engines can more clearly identify the core entities (such as articles, products, comments, events, etc.) and their attributes on a page, avoiding misunderstandings.
  2. Obtain rich media search results (Rich Results):Valid structured data is the prerequisite for rich media search results such as star ratings of websites, product prices, inventory information, and event dates.These results can significantly improve your visibility and click-through rate on the search results page.
  3. Enhance user experience:Through rich media results, users can obtain more comprehensive information before clicking into the website, which improves search efficiency and reduces invalid clicks.
  4. Avoid negative impacts:Incorrectly structured data will not bring any benefits, and may even lead to search engines ignoring your structured data, or in extreme cases, produce negative reviews.

In summary, verification is the cornerstone of ensuring that structured data is 'usable' and 'user-friendly'.

Common Json-LD verification tools and steps

Understood how AnQiCMS supports Json-LD and the importance of validation, let's move on to learning several practical validation tools and operation steps.

1. Google Rich Media Search Results Test —— Your Preferred Tool

As the world's largest search engine, Google provides a rich media search results test tool (developers.google.com/search/docs/appearance/structured-data-English）is undoubtedly the preferred choice for validating Json-LD validity.It not only checks for syntax errors, but also tells you if your structured data is eligible for Google's rich media search results.

Usage steps:

  1. Access tool:Open the Google rich media search results test page.
  2. Input information:You can choose two methods to test:
    • URL:Enter the URL of the page on your AnQiCMS website that contains Json-LD. This is the most common and convenient method.
    • Code:If your Json-LD is custom-written, you can also paste the content into the code box for testing.<script type="application/ld+json">...</script>Paste the content inside here into the code box for testing.
  3. Run the test:Click the "Test URL" or "Run Test" button.
  4. View results:The tool will provide detailed reports instantly. You should focus on:
    • "Valid" status:If it displays “This page meets the rich media search results criteria”, congratulations, your structured data syntax is correct and meets Google's basic requirements.
    • “Warning” message：“Warning usually means that your data is valid, but may be missing some recommended properties, which may limit its ability to obtain more advanced rich media results.Suggest you optimize based on the warning content.
    • “Error” message：“The error indicates that there is a syntax error in your Json-LD or missing required properties, which will cause Google to be unable to parse and use this part of the structured data.You must fix these errors.
    • Preview：“If the data is valid, the tool will also display a rich media preview of your page that may appear in search results, which helps you understand the effect intuitively.

2. Schema.org Markup Validator (Schema标记验证器) - More in-depth structure check

Schema.org is the standard organization for defining structured data, whose official Markup Validator (validator.schema.org）can provide more detailed, search engine-independent syntax and structure checking.If you want to ensure that your Json-LD strictly follows the Schema.org specifications, this tool is very useful.

Usage steps:

  1. Access tool:Open the Schema.org Markup Validator page.
  2. Input information:Similarly, you can enter the URL or paste the Json-LD code directly.
  3. Run verification:Click the “Run Test” button.
  4. Analysis report:This tool lists all detected Schema.org entities and displays any warnings or errors.It will tell you the type, attributes, and values of each entity.Its report usually focuses more on the Schema specification itself rather than Google's rendering capabilities.

3. Browser Developer Tools — Quick Screening and Location

Before submitting Json-LD data to an online validation tool, you can also use the developer tools built into your browser for a quick preliminary check.This can help you confirm whether the Json-LD script exists on the page and whether its JSON format is basically correct.

Usage steps:

  1. Open Page:Open a page containing Json-LD on your AnQiCMS website.
  2. Turn on Developer Tools:
    • Right-click anywhere on the page in Chrome browser and select "Inspect".
    • In Firefox browser, right-click on any location on the page and select 'Inspect Element'.
  3. View element:
    • Switch to the “Elements” or “Inspector” tab.
    • Use the search function (Ctrl+F or Cmd+F) to searchapplication/ld+json. You should find one or more<script type="application/ld+json">Label.
    • Click this script tag to expand its content.You can browse the structure of Json-LD roughly to confirm whether it is a valid JSON format (for example, whether the quotes and commas are correct).
  4. Check the console:Switch to the “Console” tab.If there are apparent syntax errors in the JSON format of JSON-LD, browsers may report parsing errors here sometimes.This is just the most basic check, and cannot replace professional structured data validation.

Summary

AnQiCMS provides powerful content management and SEO optimization capabilities for website operators, with support for Json-LD structured data being one of its highlights. Whether you rely on the system to generate it by default or through{% jsonLd %}Label customization, be sure to incorporate the verification process into your workflow.Fully utilize professional tools such as Google Rich Media Search Results Test and Schema.org Markup Validator, and regularly check and optimize your structured data, which will be a strong boost to your excellent performance in search engines.

Common Questions (FAQ)

Q1：My Json-LD is displayed as “valid” in the Google rich media search results test, why is there no rich media result in the search results on the website?

A1：Json-LD structured data being "valid" is just one of the prerequisites for obtaining rich media search results, but it does not guarantee that it will definitely be displayed.Google whether to display rich media results depends on various factors, such as: the quality and authority of the page content, the relevance of the page, the user's search intent, Google's real-time judgment of the algorithm, and other ranking signals.