Documentation

Breadcrumb section: show visitors where they are

Show the Home > Collection > Product trail with the Story Theme Breadcrumb section or block: separator, home icon, mobile display and SEO.

The breadcrumb is the small line of links that shows visitors where they are: Home > Collection > Product. It lets them go up one level in a click, for example back to the collection from a product page. The Story Theme offers it in two forms: a Breadcrumb section, to place on any template, and a Breadcrumb block, already included on collection and product pages.

The breadcrumb on a product page of the Hopla demo: Accueil, then the "0 à 6 mois" collection, then the product name
The breadcrumb on a product page of the Hopla demo: Accueil, then the "0 à 6 mois" collection, then the product name

What it shows on each page

The trail builds itself based on the page being visited:

PageTrail shown
Product pageHome > collection the customer came from (otherwise the product's first collection) > product
CollectionHome > collection (and the tag filter, if there is one)
Blog postHome > blog > post
Page, search, cart, accountHome > page name

It isn't shown on the home page.

The breadcrumb on the Sylys demo on the all-products collection: "Accueil › Produits"
The breadcrumb on the Sylys demo on the all-products collection: "Accueil › Produits"
The breadcrumb on the Havn demo: a house icon instead of the word Home and a slash as separator
The breadcrumb on the Havn demo: a house icon instead of the word Home and a slash as separator

Where it already is

On a fresh theme, the Breadcrumb block is already in place:

  • in the Collection section (Collection template) and in the Collections list page;
  • at the top of the buy column of the Product page, above the rating and title.
The top of a product page's buy column: breadcrumb, star rating, product title and price
The top of a product page's buy column: breadcrumb, star rating, product title and price

To adjust it, click this block in the section it belongs to. To remove it, hide it with the eye icon.

Add the section

On other pages (content pages, blog, blog posts…), add the section:

  1. In Online Store > Themes, click Edit theme and open the template you want from the dropdown at the top (for example the default page template, or the blog post template).
  2. Click Add section, open the Layout category and choose Breadcrumb.
  3. Drag the section right below the header, at the top of the list.
  4. Click the section's Breadcrumb block to adjust it.
Screenshot to take — Theme editor > default page template > Add section > Layout category open, hovering "Breadcrumb" with its preview (Home > Collection > Sample product)

In the editor, the section shows a sample trail on the home page so you can adjust how it looks.

The block is also available in Add block (Layout category): you can place it in an advanced custom section, a banner or a group.

The section itself only has the shared frame (width, spacing, palette, separators, animation: see Understand the theme editor). Everything is set in its block:

  • Home link: Text (default) or Icon (a small house).
  • Label: the text of the first link; empty, "Home" in the visitor's language.
  • Separator: Chevron (default), Slash, Vertical bar, Dot or Arrow.
  • Show the current page: the last item (product or page name), not clickable. Checked by default.
  • Add a collection on product pages: inserts the collection the customer came from, otherwise the product's first collection. Checked by default.
  • On mobile: Shorten long titles (default), Show the full trail or Back link only (a single link to the previous level).
  • Text size (13 px by default), Uppercase, Alignment and Mobile alignment.
  • Show on: Desktop and mobile, Desktop only or Mobile only.

Tips and pitfalls

  • The breadcrumb is marked up for search engines: Google can show this trail under your page's link in its results. See Optimize your pages' SEO.
  • Put your products in collections with meaningful names: their name is what appears in the middle of the trail.
  • On mobile, Back link only takes up the least space: handy on a busy product page.
  • One breadcrumb per page: if the template already has one (collection, product), don't add the section as well.

Learn more