Skip to content
50% OFF $299 $599
Lock in
§ 3.8 ARTICLE
Published VerifiedEvery 6 weeks Sources2 named Authored bySquareRank Team

Schema · § 3.8 · How-to

BreadcrumbList schema on Squarespace

BreadcrumbList is the simplest, highest-ROI install in the 12-type library. Per Google's canonical documentation1: minimum two ListItems, each with position, name, item. The visible result is the URL trail Google shows above the result snippet (Home > Services > Couples Therapy) which lifts clickthrough by a measurable amount. Squarespace does not auto-emit BreadcrumbList on the templates I've audited, which means a 60-second install captures a SERP signal the platform leaves on the table.

Install BreadcrumbList per-page (the trail differs per page) via Page Settings > Advanced > Page Header Code Injection. The schema describes the page's place in the site hierarchy, which Google uses to render the URL trail in search results and to understand how pages relate to each other.

What BreadcrumbList schema is

BreadcrumbList is the Schema.org type for a navigation trail — the path from a top-level entry point down to the current page. The shape: a top-level BreadcrumbList containing an itemListElement array, where each element is a ListItem with position (1-indexed), name (the label users see), and item (the URL of that step in the trail). The minimum trail is two items; longer trails are common (Home > Services > Couples Therapy = 3 items). Google's documentation notes that multiple parallel trails for the same page are supported when relevant.

The recommendation Google emphasises1: model the trail after the typical user path through the site, not the URL structure. A blog post might have URL /blog/2026/05/post-slug but a breadcrumb trail of Home > Writing > Coastal Design Notes > Post Title. Trails reflect site IA; URLs reflect storage hierarchy. The two often diverge.

When to use BreadcrumbList

Install BreadcrumbList on every page deeper than the home page. The home page itself does not need BreadcrumbList — it's the top of every trail. Service pages, product pages, blog posts, event pages, location pages, FAQ hubs, founder bios all benefit. The install effort is constant per page (a small JSON block); the SERP and AI-engine return is meaningful.

The honest exception: Squarespace's default sitemap generation already includes some hierarchy signals, and BreadcrumbList without a visible breadcrumb on the page may produce a Rich Results Test warning. Most Squarespace templates ship a visible breadcrumb component on at least some page types — the recommendation is to enable that component on the same pages where you install BreadcrumbList schema.

Rich-results status in 2026

BreadcrumbList rich result is active in 2026, available on desktop in all regions and languages where Google Search runs. The visible enhancement: the URL trail shown above the result snippet (instead of the raw URL). The trail tends to outperform the raw URL for click-through on long URLs — the visible IA is more readable. AI engines also use BreadcrumbList to understand page hierarchy, which feeds into entity attribution and citation decisions.

BreadcrumbList in 2026

2

minimum ListItems required for valid BreadcrumbList markup.

Google Search Central · 2025-12-10
All

regions and languages where Google supports the BreadcrumbList rich result on desktop.

Google Search Central · 2025-12-10
Active

the rich result is one of the most stable across Google's 2025-2026 structured-data deprecations.

Google Search Central · 2025-12-10

Required fields

Three fields per ListItem are required: position (1-indexed integer), name (the breadcrumb label as displayed), and item (the URL of that step). The final item's URL is technically optional — Google's documentation notes that the current page in the trail can omit item — but including it is harmless and avoids edge-case validator warnings.

  • BreadcrumbList.itemListElement — required. Array of ListItem objects.
  • ListItem.@type — literal “ListItem”.
  • ListItem.position — required. 1-indexed integer.
  • ListItem.name — required. The breadcrumb label as users see it.
  • ListItem.item — required (optional for the last item). Fully-qualified URL.

Copy-paste JSON-LD example

The block below is a three-step breadcrumb trail for a couples therapy service page on a Brooklyn-based therapy practice's Squarespace site. Replace the names and URLs with your real trail. Position starts at 1 for the top-level entry point (Home) and increments by 1 down to the current page.

JSON-LD BreadcrumbList for a service page: Home > Services > Couples Therapy 
 <script type="application/ld+json"> { "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://parkslopetherapy.com/" }, { "@type": "ListItem", "position": 2, "name": "Services", "item": "https://parkslopetherapy.com/services/" }, { "@type": "ListItem", "position": 3, "name": "Couples Therapy", "item": "https://parkslopetherapy.com/services/couples-therapy/" } ] } </script>

Where to paste it on Squarespace

BreadcrumbList goes per-page because the trail differs per page. Open the page in the Squarespace editor, Page Settings > Advanced > Page Header Code Injection, paste the script block, save. The per-page placement is non-negotiable — pasting the same BreadcrumbList into site-wide Code Injection injects the same (wrong) trail on every page.

For sites with many pages, a template-developer pattern is worth knowing about: Squarespace's developer mode (only available on Advanced plan or via custom template) allows the breadcrumb trail to be composed dynamically from the page's URL and parent collection. Outside developer mode, the per-page manual paste is the practical option.

Validation steps

Run the page URL through Google's Rich Results Test. Confirm BreadcrumbList is detected with the correct number of ListItems and zero errors. The visible URL trail in search results appears 1-3 days after detection — sometimes faster for high-traffic pages, sometimes longer for low-crawl-frequency pages.

Common validation errors: position values that skip a number (1, 2, 4 instead of 1, 2, 3), name values containing HTML markup (should be plain text), item URLs that 404 or redirect. Fix each error and re-run.

Common gotchas on Squarespace

Three gotchas catch most BreadcrumbList installs. First: pasting the same trail into site-wide Code Injection — every page now claims the same breadcrumb hierarchy. Second: the trail diverging from the visible breadcrumb on the page — Google flags this as a content/schema mismatch. Third: positions starting at 0 instead of 1 — common copy-paste error, fails validation.

A fourth Squarespace-specific gotcha: trailing-slash inconsistency. If the home page is at https://parkslopetherapy.com/ and the breadcrumb's first item is https://parkslopetherapy.com (no slash), Google may treat them as different URLs and the trail fails to connect. Match the URLs to the canonical form Squarespace serves. Most Squarespace sites use trailing slashes; verify yours.

Keep reading · § 3.8