umbraco-routing

Implement pathname-based routing for Umbraco backoffice UI components.

1|Updated May 21, 2026
One-click install
npx skills add https://github.com/1k-off/umbraco-observability-playground --skill umbraco-routing-1k-off
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: umbraco-routing
Source: https://github.com/1k-off/umbraco-observability-playground/tree/main/.agents/skills/umbraco-routing
Command: npx skills add https://github.com/1k-off/umbraco-observability-playground --skill umbraco-routing-1k-off

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you understand and implement URL-based routing in the Umbraco backoffice so navigation, sections, and dashboards work reliably with deep links.

Core Features & Use Cases

  • Backoffice navigation with pathname URLs: Build section, dashboard, and section-view paths that map cleanly to backoffice routes.
  • Custom route definitions (with parameters and redirects): Create routed UI flows using umb-router-slot, supporting dynamic segments like :id.
  • Conditions-driven display: Use conditions to ensure dashboards and views appear for the right section contexts.

Quick Start

Implement a section/dashboards setup that uses meta.pathname for stable URLs, then add routed custom elements using umb-router-slot with parameterized UmbRoute definitions.

Frequently Asked Questions about umbraco-routing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I implement deep-linking and pathname routing in the Umbraco backoffice?

To implement deep-linking in the Umbraco backoffice, use `meta.pathname` to define stable URLs for sections and dashboards, then configure routed custom elements with `umb-router-slot` and parameterized `UmbRoute` definitions.

What is the best way to configure custom routes with dynamic parameters for Umbraco dashboards?

Configuring custom routes for Umbraco dashboards involves defining route metadata with `UmbRoute` and using the `umb-router-slot` element to support dynamic URL segments like `:id` for parameterized navigation flows.

How do I ensure my custom Umbraco section views appear in the correct routing context?

You ensure custom Umbraco section views appear in the correct routing context by applying conditions-driven display rules, which guarantee dashboards and views render only for their designated section contexts.

Can I use redirects with pathname-based navigation in Umbraco backoffice UI components?

Yes, you can use redirects with pathname-based navigation by defining route metadata and validating the URL structure end to end, ensuring your custom routed elements support both deep links and redirection flows.

Why does my Umbraco backoffice routed element lose its state when navigating away?

Routed elements lose state when the URL structure lacks proper deep-linking configuration; defining stable `meta.pathname` routes and validating parameterized `UmbRoute` definitions ensures navigation state persists reliably.