Search Atlas Help Center

🛠️ Fix BreadcrumbList Schema Errors in Search Atlas

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

Camilo Aponte

Last updated on Sep 30, 2026

🔍 Overview

If Google Search Console is flagging BreadcrumbList structured data errors or Review snippet issues on your site, the most common cause is an incorrect or missing URL field in your schema markup. This article explains how to approach fixing those errors in Search Atlas, connecting Google Ads, and resolving structured data warnings reported by Google Search Console.

📋 Before You Begin

  • Make sure your site is added and verified in Search Atlas.
  • Have Google Search Console open in a separate tab so you can cross-reference the specific errors being reported.
  • Confirm you have Editor or Admin access in your Search Atlas workspace.

🗂️ Step 1 — Locate Your Site in Search Atlas

  1. Log in to Search Atlas.
  2. Find your site in the site list and click its name to open the site dashboard.

🔗 Step 2 — Navigate to Schema Settings

  1. From your site dashboard, locate the schema or structured data tools available for your site.
  2. Find the BreadcrumbList schema associated with the page or pages flagged in Google Search Console.

✏️ Step 3 — Update the URL Field in BreadcrumbList Schema

The BreadcrumbList schema requires every ListItem to contain a valid, absolute URL in its item property. A missing, relative, or malformed URL is the most frequent cause of Google Search Console errors.

  1. Open the BreadcrumbList schema entry for editing.

  2. Review each ListItem in the breadcrumb sequence. Each item should have a Name field and a URL field.

  3. Ensure each URL value is an absolute URL — it must begin with https:// and match the exact canonical URL of that page.

  4. Common issues to fix in the URL field:

    • Relative paths such as /toys/ — replace with the full absolute URL.
    • Trailing slash inconsistency — match the format used in your sitemap and canonical tags.
    • Typos or extra characters in the domain name.
    • HTTP URLs on an HTTPS site — always use https://.

  5. After correcting each URL field, save your changes to apply them.

  6. If your BreadcrumbList schema is deployed site-wide via a template, update the URL pattern in the template so all pages inherit the corrected format.

📊 Step 4 — Validate Your Changes

  1. After saving, use Google Search Console's Rich Results Test or the URL Inspection tool to confirm the BreadcrumbList errors are resolved.
  2. If Review snippet errors were also reported, check that your Review schema includes all required fields (such as ratingValue and reviewCount) and that the schema is properly associated with the correct page.

🔗 Step 5 — Connect Google Ads (if applicable)

If your workflow also requires connecting Google Ads as part of schema deployment or site metrics setup, follow these steps:

  1. Navigate to the integrations or connected accounts section of your Search Atlas workspace settings.
  2. Select Google Ads and follow the on-screen prompts to authorize the connection using your Google account credentials.
  3. Once connected, verify that data is flowing correctly by checking the relevant reporting or metrics area within Search Atlas.
  4. If you encounter an error during the Google Ads connection process, note the exact error message displayed and the timestamp, as these will be needed if you require further support.

⚠️ If You Cannot Locate the Schema or Google Ads Settings

Because Search Atlas is actively developed, the exact location of schema tools and integrations may vary depending on your plan or workspace configuration. If you cannot find the areas described above, please have the following ready before reaching out to support:

  • Your site name and the URL(s) flagged in Google Search Console.
  • The exact error message(s) shown in Google Search Console.
  • A screenshot of the error and the page(s) affected.
  • Whether you are trying to connect Google Ads, deploy schema, or troubleshoot structured data warnings — or a combination of these.

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.