SScale Themedocs

Breadcrumb trail with automatic hierarchy detection. Contextual navigation to improve SEO and UX.

Breadcrumb

The breadcrumb is a secondary navigation bar that displays the hierarchy of the current page. It helps visitors orient themselves within your store's structure and makes it easy to navigate to parent pages.

How it works

The breadcrumb automatically detects the current page's hierarchy from the Shopify navigation structure and the URL. No manual configuration is needed.

Example paths

PageBreadcrumb
ProductHome > Collection > Product name
CollectionHome > Collections > Collection name
PageHome > Page title
BlogHome > Blog > Article title
SearchHome > Search
CartHome > Cart
ℹ️On a product page, the collection shown in the breadcrumb is the one the visitor arrived from. If the visitor lands directly on the product (direct link, Google), the product's primary collection is used.

Automatic detection

The breadcrumb determines the hierarchy from several sources:

SourcePriorityDescription
ReferrerHighIf the visitor came from a collection, it is used
Default collectionMediumThe product's first collection
URLLowURL analysis to infer the structure

Display

AspectDescription
SeparatorChevron (>) between each level
Active pageThe last element (current page) is not clickable
HomeAlways the first element, with the label "Home"
TruncationOn mobile, intermediate levels may be truncated

Responsive

ViewportBehavior
DesktopFull path displayed on a single line
MobileAbbreviated path if too long, with horizontal scroll or truncation
💡On mobile, the breadcrumb can get long and span multiple lines. The theme handles this automatically by truncating intermediate levels when necessary.

SEO

The breadcrumb automatically generates structured data (schema.org BreadcrumbList) to improve display in Google search results:

{
  "@type": "BreadcrumbList",
  "itemListElement": [
    { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://..." },
    { "@type": "ListItem", "position": 2, "name": "Dresses", "item": "https://..." },
    { "@type": "ListItem", "position": 3, "name": "Long Black Dress" }
  ]
}
ℹ️Breadcrumb structured data is automatically generated. It allows Google to display the breadcrumb trail directly in search results, improving click-through rate (CTR).

Supported pages

The breadcrumb is automatically displayed on all pages except the homepage:

PageBreadcrumbNotes
HomepageNoNo breadcrumb on the homepage
CollectionYesHome > Collection name
ProductYesHome > Collection > Product
PageYesHome > Page title
BlogYesHome > Blog
ArticleYesHome > Blog > Article
SearchYesHome > Search
CartYesHome > Cart
AccountYesHome > My Account

Best practices

  1. Keep it active: The breadcrumb is a web navigation standard. Visitors expect to find it, especially on stores with a large catalog
  2. SEO: The generated structured data improves your search ranking. Don't disable the breadcrumb for aesthetic reasons
  3. Organized collections: The breadcrumb is most useful when your collection structure is logical and hierarchical
  4. Short names: Short collection and product names make the breadcrumb more readable, especially on mobile