umbraco-search-result-item

Render custom Umbraco backoffice search result items with entity-specific icons and metadata.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of generic, hard-to-read search results in the Umbraco backoffice by letting you control how each individual result item is rendered for your entity types.

Core Features & Use Cases

  • Entity-specific result UI: Render custom visuals (icons, badges, extra metadata) based on the result’s entity type.
  • Improved backoffice clarity: Show additional fields (like descriptions, status, updated date) alongside the name to help editors scan faster.
  • Provider-compatible models: Adapt the element to the shape of your search provider output using the result item model and custom fields.

Quick Start

Ask an AI to generate a complete working Umbraco backoffice searchResultItem manifest and element for your target entity type, using the latest Umbraco documentation, then tell you exactly how to test it in the backoffice.

Frequently Asked Questions about umbraco-search-result-item

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

FAQPage Schema
How do I customize Umbraco backoffice search results to show custom icons and metadata?

Customizing Umbraco backoffice search results involves implementing a ManifestSearchResultItem with a forEntityTypes mapping and a Lit custom element. This renders entity-specific UI with icons, badges, and metadata beyond the default rendering.

What is a ManifestSearchResultItem in Umbraco and when do I need it?

A ManifestSearchResultItem is an Umbraco extension registry component that maps a custom element to specific entity types. You need it when default search result rendering lacks the icons, badges, or metadata editors require to scan results effectively.

How do I build a custom search result item element using Lit for Umbraco?

Build a custom search result item by creating a Lit custom element that renders UI based on the search result item model. Register it through the Umbraco extension registry with a forEntityTypes mapping to target specific entity types.

Can I display extra description and status fields in Umbraco backoffice search results?

Yes, you can display additional fields like descriptions, status, and updated dates by adapting your custom element to the search provider output. The result item model supports custom fields for entity-specific rendering.

Does Umbraco custom search result rendering work with different search providers?

Yes, the custom element is provider-compatible. You adapt the element rendering to the shape of your search provider output using the result item model and custom fields, ensuring stable UI across different providers.

Why are my Umbraco backoffice search results showing generic names without icons or badges?

Default Umbraco search results render generic names without entity-specific visuals. Implementing a ManifestSearchResultItem with a custom Lit element for your entity types adds icons, badges, and metadata to improve clarity.