Menu
Feedback
Start here
Tutorials
Developer portal

Known Issues
Support Rules
Troubleshooting

Frequently Asked Questions
Announcements
Tutorials
Tutorials
Explore in-depth tutorials for operating your VTEX store.
Tutorials
Storefront
Layout
Breadcrumb control
Breadcrumb control

Breadbrumbs improve the in-store browsing experience by encouraging users to explore their page hierarchy.

In VTEX, the <vtex.cmc:breadCrumb/> control is responsible for rendering breadcrumbs like the one below.

{"base64":"  ","img":{"width":362,"height":54,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":1613,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Storefront/Layout/breadcrumb-control_1.png"}}

If, as in this example, the user directly accesses the page of a product of the category Camisetas, the breadcrumb displayed on the product page will give you the information that the user is in this category (Camisetas), which is below the department Moda masculina.

This control works only on the following page types:

  • Product
  • Department
  • Category
  • Search

Here is an example of the HTML code rendered by the breadcrumb control:


<div id="box-bread-brumb" class="hidden-xs"><div class="bread-crumb" xmlns:v="http://rdf.data-vocabulary.org/#">
<ul>
<li typeof="v:Breadcrumb"><a href="http://lojadobreno.vtexcommercestable.com.br/" rel="v:url" property="v:title">lojadobreno</a></li>
<li class="last" typeof="v:Breadcrumb"><a href="http://lojadobreno.vtexcommercestable.com.br/livros" rel="v:url" property="v:title">Livros</a></li></ul>
</div>
</div>

The code above renders the following breadcrumb in the site:

{"base64":"  ","img":{"width":180,"height":47,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":676,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Storefront/Layout/breadcrumb-control_2.png"}}

Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Was this helpful?
Yes
No
Suggest Edits (GitHub)
Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
On this page
Still got questions?
Ask the community
Find solutions and share ideas in the VTEX community.
Join our community
Request support from VTEX
For personalized assistance, contact our experts.
Open a support ticket
GithubDeveloper portalCommunityFeedback