creating-backstage-entity-page-extension
Installation
SKILL.md
Creating Catalog Entity Page Extensions
When to use this skill
- Adding a card to the Overview tab of a catalog entity (e.g. "show Jira project info on Components linked to a Jira project")
- Adding a whole tab (a content panel with its own URL path) to a catalog entity page (e.g. "/incidents" tab on Components, listing the component's incidents)
- Filtering when an extension appears, based on entity kind, spec type, annotation presence, or any custom predicate
This is the most common reason to scaffold a frontend-plugin-module. The plugin you're authoring extends the host's catalog plugin via these blueprints.
Choose the right pattern
| Building... | Pattern | Reference |
|---|---|---|
| A card on the entity Overview tab | EntityCardBlueprint.make({ name, params: { loader, filter?, type? } }) |
references/card.md |
| A full tab (its own URL path) on the entity page | EntityContentBlueprint.make({ name, params: { path, title, loader, filter?, group?, icon? } }) |
references/content.md |
Both blueprints come from @backstage/plugin-catalog-react/alpha. They share: