umbraco-picker-data-source

Implements Umbraco picker data sources for property editors via extension manifests and controllers.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Custom content picker UIs often need tailored data shapes, filtering rules, and search behavior that aren’t available out of the box, which slows down backoffice development.

Core Features & Use Cases

  • Picker item provisioning: supplies items for tree-based and collection-based picker property editors, including how selected values are resolved back to entities.
  • Search and filtering: implements query-driven search and pickable-item filtering for large or structured datasets (e.g., only allow certain node types).
  • Extensibility via extension manifests: registers data sources so property editors can use them with clear aliases and metadata.

Quick Start

Implement a picker data source by defining an extension manifest and controller class that returns tree roots/items and supports search for your custom entity type.

Frequently Asked Questions about umbraco-picker-data-source

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

FAQPage Schema
How do I create a custom picker data source in Umbraco backoffice?

To create a custom picker data source in Umbraco, you define an Umb extension manifest registering a propertyEditorDataSource and implement a controller class with methods like requestTreeRoot, requestItems, and search to supply structured, filtered items for backoffice property editors.

How does search filtering work for Umbraco tree picker property editors?

Search filtering for Umbraco tree pickers works by implementing the searchPickableFilter and search controller methods in your data source, allowing content editors to query and filter large datasets directly within the backoffice picker interface.

When do I need a custom collection picker data source in Umbraco?

You need a custom collection picker data source in Umbraco when out-of-the-box property editors cannot handle tailored data shapes, specific filtering rules, or custom entity resolution by ID required for your structured datasets.

Can I configure Umbraco property editors to only allow specific node types in a picker?

Yes, you can restrict selectable node types in Umbraco property editors by implementing a custom picker data source with query-driven search and pickable-item filtering logic to enforce which specific entities content editors are allowed to select.

How do I resolve selected uniques by ID in an Umbraco picker data source?

To resolve selected uniques by ID in an Umbraco picker, your custom data source controller must implement the requestItems method, which fetches and returns the specific entities corresponding to the selected IDs back to the property editor.

What is an Umb extension manifest for property editor data sources?

An Umb extension manifest for property editor data sources is a configuration file in Umbraco that registers your custom picker data source with clear aliases and metadata so backoffice property editors can locate and utilize it.