umbraco-header-apps

Implement Umbraco Backoffice header apps with manifests and Lit elements.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps you implement Umbraco Backoffice header apps so you can deliver globally available actions and quick links directly in the top navigation.

Core Features & Use Cases

  • Fetch the latest official documentation before implementing header apps to ensure you follow current Umbraco extension patterns.
  • Create simple button/link header apps that route users to external pages like documentation or internal tools.
  • Build interactive header apps with a Lit element (modal opening, actions, or other interactive behavior) that integrates cleanly into Umbraco’s header app framework.
  • Use cases: global tool shortcuts, quick access to help resources, and interactive utilities that trigger modals or actions from anywhere in the Backoffice.

Quick Start

Tell the agent what your header app should do (simple link vs interactive), including its label, icon, and destination/action, and ask it to generate the required manifest and element following the latest Umbraco header app docs.

Frequently Asked Questions about umbraco-header-apps

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

FAQPage Schema
How do I add custom quick links to the Umbraco Backoffice top navigation?

To add custom quick links to the Umbraco Backoffice top navigation, you implement header apps using a TypeScript manifest. This generates globally accessible buttons that route users to external pages or internal tools directly from the header.

Can I build interactive modals in the Umbraco header app?

Yes, you can build interactive modals in an Umbraco header app by defining a Lit element component. This Lit element integrates cleanly into Umbraco's framework to handle interactive actions like opening modals or triggering action handlers across the Backoffice.

What is the difference between a simple button and an interactive header app in Umbraco?

A simple button header app in Umbraco provides direct routing to links, while an interactive header app uses a Lit element to trigger complex UI behaviors. Lit elements enable modals and action handlers, whereas simple buttons only navigate to destinations.

Do I need TypeScript to customize the Umbraco Backoffice header?

Yes, TypeScript is required to customize the Umbraco Backoffice header. Header apps are implemented as UI extensions using TypeScript and Lit to generate the correct manifest and element code needed for the Backoffice integration.

How do I validate and test an Umbraco header app extension?

To validate and test an Umbraco header app extension, you follow the official header app documentation to ensure correct manifest and element code generation. This process confirms that the interactive Lit components and button actions integrate cleanly into the Backoffice.