orchardcore-breadcrumbs

Orchard Core Breadcrumbs

Orchard Core 4.0 renders admin page titles as a named trail with an explicit current-page title, e.g. Dashboard › Manage Content › Edit Article. The Breadcrumb and BreadcrumbItem shapes live in the always-enabled OrchardCore.Navigation module; the tag helpers live in OrchardCore.Navigation.Core. No feature needs to be enabled and inline authoring needs no provider registration.

Mental Model

• The parent <breadcrumb> declares the trail name and the current page title. Both are required.
• Every <breadcrumb-item> child is an ancestor, never the current page.
• For a visible trail the helper collects children in declaration order, runs every IBreadcrumbProvider in DI registration order on the same ancestor list, keeps the resulting order (no sorting), then always appends the title as the final, unlinked current node with the fixed Id = "Title".
• On admin requests the helper also renders the title as an <h1> below the trail and registers it as a <title> segment, so the view must not render its own heading.
• Visibility is decided first. A hidden admin trail skips all child and provider work and uses only the explicit title (see "Hiding Admin Breadcrumbs").
• Keep built-in-style views inline: the title and screen-specific ancestors in the owning view, a lightweight provider only for shared or cross-module ancestor changes, and shape alternates for presentation. No breadcrumb manager, builder, or named-provider base class exists or is needed.
• INavigationProvider is unrelated: it builds menus, not breadcrumb trails.

Adding a Breadcrumb to a View

Import the tag helpers once in the module's Views/_ViewImports.cshtml (reference the OrchardCore.Navigation.Core package or project):

@addTagHelper *, OrchardCore.Navigation.Core

Put the helper in the Title zone, replacing the old <h1> and any @RenderTitleSegments(...) call for the same title:

<zone Name="Title">
    <breadcrumb name="RecordsEdit" title="@T["Edit {0}", Model.Record.Name]">
        <breadcrumb-item id="Records" action="Index" controller="Record" area="My.Module"
                         permission="@MyPermissions.ManageRecords.Name">@T["Records"]</breadcrumb-item>
    </breadcrumb>
</zone>