Salesforce Docs Portal

Choose Product Categories to Use in Breadcrumbs

The order of breadcrumbs is determined by a combination of a category and product and the date and time that their association was established. The first category that a product is associated with is the product’s primary category and becomes the basis of the breadcrumb order. You can customize the default order of breadcrumbs by explicitly identifying categories as primary. When you identify a category as primary, your store uses it to construct the category path that populates the breadcrumbs on the Product Detail page. You can associate a product with multiple categories, but it can have only one primary category.

Required Editions

When a product is associated with just one category, you don’t need to explicitly mark the category as primary. By default, that single category is the product’s primary category. However, when a product is associated with multiple categories, a primary category can be useful. For example, let’s say that your store offers a table saw that’s associated with the Power Tools category. This association is reflected in the breadcrumb on the Product Detail page. You’re having a sale, so you associate the tool with a Sale category. To have the Sale category appear in the breadcrumb on the tool’s Product Detail page, mark Sale as the tool’s primary category.

Note
Note Before you can mark a product category as primary, your admin must set up the layout on the Product object to include the Category related list.
  1. In the navigation sidebar, select a store from the Store dropdown.
  2. Select Merchandising | Products.
  3. Click a product name to open its detail page, and select the Related tab.
  4. In the Categories section, click the actions dropdown across from the category, and select Set as Primary Category.
    Tip
    Tip On the Related tab, you can also select Edit from a product’s actions dropdown, and select Is Primary Category.

Keep these behaviors in mind when working with breadcrumbs.

  • If a category isn’t included in navigation—that is, Show in Menu isn’t selected—it doesn’t appear in the breadcrumb, even if it’s marked as primary. Instead, Home is used in the breadcrumb. Also, if the product has only one associated category, and that category is non-navigational, the breadcrumb displays Home.
  • If you delete a primary category and that category is the only one assigned to a product, the product becomes unavailable in store navigation. If multiple categories are associated with the product, the oldest product-category association determines which category is primary.
  • If you make a primary category inactive, all products that are associated with only that category become unavailable in store navigation. If multiple categories are associated with the product, the oldest product-category association determines which category is primary.
  • If you remove a product from the primary category, the product’s next category, based on the assigned date, becomes the new primary. If the product doesn’t have other categories, it becomes unavailable in store navigation.

See Also