recipe-find-and-update-document

Locate an Umbraco document by content-tree path, update a property, and publish.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you locate a specific Umbraco document in the content tree, change one or more properties, and publish it without manually hunting for IDs or risking accidental edits.

Core Features & Use Cases

  • Path-based discovery: Finds the target document by walking the site tree (e.g., "Home/Partners/Partner List").
  • Targeted property update: Reads only the needed fields, then updates a specific property (example: updating skills).
  • Safe publishing workflow: Uses --dry-run for mutations and then publishes with an explicit publish schedule payload.

Quick Start

Ask an AI to run the steps to find the document at "Home/Partners/Partner List", update the skills property to "C#;Go", and publish it.

Frequently Asked Questions about recipe-find-and-update-document

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

FAQPage Schema
How do I update an Umbraco document property by content tree path?

You can update an Umbraco document property by walking the content tree via CLI to locate the target node path, then using document get/update/publish calls with selective fields and JSON output to modify specific properties safely.

What is the safest way to publish Umbraco content changes via CLI?

The safest way to publish Umbraco content changes is using a dry run for mutations before applying an explicit publish schedule payload, verifying modifications on stable IDs returned by API responses without risking accidental edits.

Can I use CLI automation to find an Umbraco document without knowing its ID?

Yes, you can use CLI automation to find an Umbraco document without knowing its ID by walking the site tree path, such as "Home/Partners/Partner List", which returns the stable ID needed for subsequent updates.

Does this approach support updating multiple Umbraco properties at once?

Yes, the workflow supports targeted property updates by reading only the needed fields and updating specific properties, allowing you to change one or more values before triggering the publish action.

What are the limitations of using path-based discovery for Umbraco documents?

Path-based discovery relies on deterministic CLI calls using Umbraco tree walk and JSON output, meaning it requires an exact content tree path structure and may not work if the tree hierarchy is changed or ambiguous.

Why does my Umbraco document update require a dry run before publishing?

A dry run is required before publishing to validate mutations safely, ensuring the document update targets the correct stable IDs returned by the API and preventing accidental edits to the content tree.