# Breadcrumbs

<figure><img src="https://3723856256-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGnixyIfIYFWroNtVmZo6%2Fuploads%2Fgit-blob-f2be05c4884f41b82dd7b400e8620e487faa7be3%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

## Overview

A comprehensive breadcrumb navigation component that displays the current page's location within the site hierarchy. The component shows a path from the home page to the current page, with specialized support for article and product templates. For custom paths, use product metafields `product.metafields.custom.breadcrumbs` or article metafields `article.metafields.custom.breadcrumbs` (namespace and key must match your store setup). Dropdown behavior helps when multiple breadcrumb links would otherwise overcrowd the row.

## Common use cases

* Configure custom breadcrumb metafields in your content management for complex navigation structures
* Choose appropriate color schemes that provide sufficient contrast for readability
* Use padding options thoughtfully to ensure proper spacing within container elements
* Consider the visual hierarchy when placing breadcrumbs - typically best positioned near the top of content areas
* Test with long collection and article titles to ensure proper truncation behavior
* Ensure breadcrumb links are contextually relevant to the user's navigation path

## Block settings

### General

| Setting                | Description                 | Options                   |
| ---------------------- | --------------------------- | ------------------------- |
| Show advanced settings | Reveals visibility settings | Checkbox (default: false) |

### Spacing

| Setting                   | Description                                    | Options                   |
| ------------------------- | ---------------------------------------------- | ------------------------- |
| Enable horizontal padding | Adds horizontal padding around the breadcrumbs | Checkbox (default: false) |
| Enable top padding        | Adds top padding around the breadcrumbs        | Checkbox (default: false) |
| Enable bottom padding     | Adds bottom padding around the breadcrumbs     | Checkbox (default: false) |

### Color

| Setting      | Description                          | Options                                                                                                                                                                                                                                                      |
| ------------ | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Color scheme | Controls the background color scheme | <p>• Body<br>• Neutral<br>• Accent 1 (default)<br>• Accent 2<br>• Accent 3<br>• Shade 1<br>• Shade 2<br>• Shade 3<br>• Primary<br>• Secondary<br>• Tertiary<br>• Blur<br>• Transparent</p>                                                                   |
| Text color   | Controls the text color              | <p>• Default (default)<br>• Alternative<br>• Primary background<br>• Primary foreground<br>• Secondary background<br>• Secondary foreground<br>• Tertiary background<br>• Tertiary foreground<br>• Neutral background<br>• Neutral foreground<br>• Shade</p> |

### Style

| Setting     | Description                                       | Options                                                                                                                                                           |
| ----------- | ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Font family | Controls the font family used for the breadcrumbs | <p>• Standard (default)<br>• Heading<br>• Subheading<br>• Accent<br><br>Visible when font size contains 'type--'</p>                                              |
| Font size   | Controls the font size of the breadcrumbs         | <p>• Smaller<br>• Small<br>• Default (default)<br>• Big<br>• Bigger<br>• Heading 1<br>• Heading 2<br>• Heading 3<br>• Heading 4<br>• Heading 5<br>• Heading 6</p> |

### Layout

| Setting              | Description                   | Options                                        |
| -------------------- | ----------------------------- | ---------------------------------------------- |
| Horizontal alignment | Controls horizontal alignment | <p>• Left (default)<br>• Center<br>• Right</p> |

### Display

| Setting    | Description                        | Options                                                                                                                            |
| ---------- | ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| Visibility | Controls when the block is visible | <p>• All (default)<br>• Mobile only<br>• Desktop only</p><p><br><br>Visible when <strong>Show advanced settings</strong> is on</p> |