umbraco-validation-checks

Guide manual Umbraco backoffice extension validation across permissions, navigation, API, forms, and workspace actions.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Umbraco backoffice extensions fail validation or behave inconsistently in the UI, and developers need a repeatable way to pinpoint whether the issue is permissions, navigation, API payloads, form bindings, or workspace actions.

Core Features & Use Cases

  • Configuration & permissions checks: Confirm sections and user-group access are enabled so the extension is even visible.
  • Navigation & menu visibility checks: Diagnose missing or broken tree/menu items caused by alias/manifest issues or hidden actions.
  • API debugging for failures (especially 400s): Inspect DevTools network payloads and headers to identify wrong structure, enum formats, GUID formatting, auth/CORS issues, and “empty select” traps.
  • Form control checks: Verify uui-select/combobox option formatting and correct property/event bindings to prevent null/undefined values that lead to 400 responses.
  • Workspace behavior checks: Identify missing Save workspace actions, empty workspace data loads, and submit persistence failures.

Quick Start

Use the Umbraco backoffice validation workflow by opening Chrome DevTools first, then load the appropriate check category files based on the symptom you see (configuration, navigation, API debugging, form controls, or workspace).

Frequently Asked Questions about umbraco-validation-checks

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

FAQPage Schema
Why does my Umbraco backoffice extension return a 400 payload error during browser testing?

A 400 payload error in Umbraco backoffice extensions often stems from incorrect API payloads, wrong enum formats, or GUID formatting issues. Validate your DevTools network payloads and headers against expected DTO formats and auth/CORS constraints to identify the mismatch.

How do I troubleshoot missing sections and menu items in Umbraco backoffice extensions?

To troubleshoot missing Umbraco sections or menu items, check configuration and user-group permissions first. Then diagnose navigation and tree visibility for alias or manifest issues, and verify hidden workspace actions that might prevent proper UI rendering.

How do I fix empty uui-select combobox options causing null values in Umbraco?

To fix empty uui-select combobox options causing null values in Umbraco, verify correct property and event bindings. Ensure option formatting is correct to prevent null or undefined values from triggering failed API requests.

What causes non-functional workspace save and submit flows in Umbraco backoffice extensions?

Non-functional workspace save and submit flows in Umbraco backoffice extensions are caused by missing workspace actions, empty workspace data loads, or submit persistence failures. Verify workspace action registration and inspect DevTools for API failures.

Can I use Chrome DevTools to diagnose Umbraco backoffice API and network failures?

Yes, Chrome DevTools is required for diagnosing Umbraco backoffice API and network failures. You inspect network payloads, verify headers, and check auth/CORS constraints to pinpoint incorrect structures causing failing API requests.

What is the best way to validate Umbraco backoffice extension behavior?

The best way to validate Umbraco backoffice extension behavior is a symptom-to-category triage workflow. Open Chrome DevTools, load the matching check category for permissions, navigation, API, forms, or workspace, and verify payload and header formats.