Search Atlas Help Center

🍞 Fix Missing Item URL in Breadcrumb Schema

Open in
View as Markdown Open in ChatGPT Open in Claude
Camilo Aponte

Camilo Aponte

Last updated on Sep 30, 2026

🔍 What Is This Issue?

When MetaSync generates a BreadcrumbList schema on custom taxonomy archive pages (such as category, tag, or custom taxonomy archives), it may omit the item URL property from one or more breadcrumb list elements. Google Search Console flags this as a "Missing field item" error in the Rich Results report, which can prevent your breadcrumbs from appearing in search results.

This typically affects pages like /blog/category/news/ or any archive URL tied to a custom taxonomy, where the taxonomy label is included in the breadcrumb trail but its corresponding URL is not passed through to the schema markup.

⚠️ Why Does This Happen?

The BreadcrumbList schema requires every ListItem to include three properties:

  • @type — set to ListItem
  • position — the numeric order of the item in the trail
  • item — an object containing the @id (URL) and name of that breadcrumb step

On taxonomy archive pages, MetaSync may resolve the taxonomy label correctly but fail to attach the corresponding archive URL to the item property. The result is a ListItem entry with a name but no URL, which Google treats as invalid markup.

🛠️ How to Fix the Missing Item URL

Follow the steps below to manually correct the breadcrumb schema for your taxonomy archive pages using the Search Atlas Schema module.

  1. Log in to Search Atlas and navigate to the Schema Creator by clicking the apps-grid icon in the header, then selecting More Features → Schema Creator.
  2. Search for the taxonomy archive page that is generating the error (for example, a category or custom taxonomy archive URL).
  3. Open the existing BreadcrumbList schema for that page. If no schema exists, create a new one by selecting BreadcrumbList from the schema type menu.
  4. Locate the ListItem entry that corresponds to the taxonomy label (this is the step missing its URL).
  5. In the item field for that ListItem, enter the full absolute URL of the taxonomy archive page — for example, https://yourdomain.com/blog/category/news/.
  6. Confirm that every ListItem in the breadcrumb trail has a valid name, position, and item URL populated.
  7. Save the schema and use the Google Rich Results Test (search.google.com/test/rich-results) to validate the updated markup before resubmitting in Search Console.

✅ How to Verify the Fix in Google Search Console

  1. Go to Google Search Console and open the Enhancements section in the left menu.
  2. Select Breadcrumbs to view the current error report.
  3. Click on the "Missing field item" error to see affected URLs.
  4. After applying the fix in Search Atlas, click Validate Fix next to the affected URLs.
  5. Google typically re-crawls and updates the status within a few days to two weeks.

🧩 Additional Notes

  • If you are using Rank Math or another SEO plugin alongside MetaSync, check that both tools are not outputting competing BreadcrumbList schemas on the same page. Duplicate or conflicting schema blocks can cause further validation issues. Disable breadcrumb schema output from the third-party plugin if MetaSync is your primary schema tool.
  • Custom taxonomy archives sometimes require the breadcrumb trail to be configured manually, as MetaSync cannot always resolve dynamic archive URLs automatically.
  • If your breadcrumb schema was previously generating valid markup and stopped after a recent update, check the Schema module for any unsaved changes or reset configurations.

💬 Need More Help?

If you need further assistance, open the chat widget in the bottom-right corner of the platform and type human teammate to be connected with a member of our team.