umbraco-conditions

Define Umbraco backoffice Extension Conditions using YAML frontmatter and AND logic.

4|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/albanistrefi/umbraco_CLI --skill umbraco-conditions-albanistrefi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: umbraco-conditions
Source: https://github.com/albanistrefi/umbraco_CLI/tree/main/skills/foundation/umbraco-conditions
Command: npx skills add https://github.com/albanistrefi/umbraco_CLI --skill umbraco-conditions-albanistrefi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you define Umbraco backoffice Extension Conditions so extensions appear only when the required context and permissions are met, avoiding confusing or cluttered UI.

Core Features & Use Cases

  • Condition-based gatekeeping: Configure when dashboards, views, and actions become visible based on section, workspace, user permissions, content type, or other context signals.
  • AND logic across multiple conditions: Combine several constraints so all requirements must pass for the extension to render.
  • Built-in and custom conditions: Use standard condition aliases (like section alias or workspace content type) and follow patterns to implement custom conditions via the extension API.

Quick Start

Use the built-in condition aliases from Umb.Condition.* in your extension manifest, then validate the intended visibility rules by matching them to the backoffice context where the extension should appear.

Frequently Asked Questions about umbraco-conditions

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

FAQPage Schema
How do I conditionally display Umbraco backoffice extensions based on user permissions?

You can conditionally display Umbraco backoffice extensions by defining Extension Conditions in your manifest. These conditions gate visibility based on section, workspace, user permission, and content type context to prevent UI clutter.

What are Umbraco extension conditions and when should I use them?

Umbraco extension conditions control when dashboards, workspace views, and actions render in the backoffice. Use them when extension visibility and execution must be restricted to specific backoffice scenarios like particular sections or content types.

Can I combine multiple visibility rules for a single Umbraco dashboard?

Yes, you can combine multiple visibility rules for a single Umbraco dashboard using AND semantics. This requires all configured constraints, such as section alias and workspace content type, to pass before the extension renders.

How do I create a custom condition for an Umbraco workspace view?

To create a custom condition for an Umbraco workspace view, implement custom UmbConditionBase logic via the extension API. This allows you to evaluate specific context signals beyond the standard built-in condition aliases.

Does this approach support restricting Umbraco actions to specific content types?

Yes, restricting Umbraco actions to specific content types is supported. You apply condition-based gatekeeping to action manifests so they only become visible and executable when the required content type context is met.

Why are my Umbraco backoffice extensions showing up in the wrong sections?

Extensions show up in wrong sections when manifests lack proper visibility gating. You must apply built-in Umb.Condition aliases or custom logic to restrict rendering to the correct backoffice scenarios and avoid confusing UI.