Skip to main content

Updating Components

After ingesting components into your catalog, you'll need to keep their metadata up to date. Portal provides two editing interfaces for updating component information.

Editing Portal-Managed Components​

For components managed by Portal, use these editing tools to update metadata:

Edit Entity Dialog​

Update individual components using the Edit Entity dialog, which provides a focused interface for modifying a single component's metadata.

Edit Entity Dialog

To access:

  • Navigate to the component's page in the catalog
  • Click the 3 vertical dots in the top right
  • Click the edit entity button

Bulk Edit Dialog​

Update multiple components at once using the Bulk Edit dialog. This is the most efficient way to apply consistent changes across many components.

Bulk Edit Dialog

To access:

  • Select multiple components from the catalog page
  • Click the pencil icon next to the filters in the top right.

These are the primary ways to manage Portal-managed entities. All metadata changes are immediately saved to Portal's database.

Editing YAML-Managed Components​

For components managed by YAML, you have three ways to update metadata:

1. Edit the catalog-info.yaml File​

Update components by directly editing the catalog-info.yaml file in your repository. Portal automatically syncs changes when you commit to your repository. This is the source of truth for YAML-managed components.

2. Edit Entity Overlay​

Update individual components using the Edit Entity Overlay dialog. This provides the same UI interface as Portal-managed components but applies changes as overlays on top of the YAML definition.

Edit Entity Overlay

To access:

  • Navigate to the component's page in the catalog
  • Click the 3 vertical dots in the top right
  • Click the edit entity button

3. Bulk Edit Dialog​

Update multiple YAML-managed components at once using the Bulk Edit dialog. These changes are also applied as overlays on top of the YAML definitions.

Bulk Edit Dialog

To access:

  • Select multiple components from the catalog page
  • Click the pencil icon next to the filters in the top right

Both editing interfaces support updating core component fields including owner, lifecycle, type, labels, and annotations.