## **🔍 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.