umbraco-document

Manage Umbraco document trees and content records via CLI.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you reliably inspect and manage Umbraco documents (read, search, and perform safe mutations) without manually navigating the back office.

Core Features & Use Cases

  • Read & explore content: Quickly fetch ancestors, children, root documents, or a specific document by ID, and run document search with pagination and query parameters.
  • Perform safe updates and lifecycle actions: Create, update, move, publish/unpublish, trash/restore, and bulk-update documents with guardrails like dry-run validation.
  • Handle payloads efficiently: Limit responses with flags like --fields and summarize results, while updating via JSON payloads, merge-json, or property-level updates.

Quick Start

Use the Skill to search for documents under a specific parent and retrieve only the fields you need by running: umbraco document search --under 123 --params '{"query":"home","take":10}' --fields id,name,alias.

Frequently Asked Questions about umbraco-document

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

FAQPage Schema
How do I bulk update Umbraco documents without using the back office?

You can bulk update Umbraco documents by using CSV-driven updates or JSON payloads. This approach replaces manual back-office edits by applying mutations across multiple content records programmatically while maintaining data consistency.

How do I search for Umbraco content records with specific fields?

To search Umbraco content records, use document search with pagination and query parameters. You can limit API responses by specifying fields like id, name, and alias to retrieve only the exact content data you need.

Can I validate Umbraco content mutations before publishing them?

Yes, you can validate Umbraco content mutations before publishing them by using dry-run validation. This feature provides mutation safety by testing create, update, move, or publish actions to ensure operations succeed before applying changes to live content.

What is the best way to automate Umbraco document lifecycle actions?

The best way to automate Umbraco document lifecycle actions is through API automation. This method manages create, update, publish, unpublish, trash, and restore operations programmatically, ensuring safe and repeatable content operations across document trees.

Do I need the umbraco CLI to manage document trees?

Yes, you need the umbraco CLI with shared auth and global flags from umbraco-shared to manage document trees. This environment setup provides the necessary command-line interface and authentication context for executing document discovery and back-office data mutations.