Skip to main content

Documentation Index

Fetch the complete documentation index at: https://backstage.spotify.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

You’ve selected Managed by Portal mode. Here’s what happens next as you complete the remaining steps.

Step 4: Select Repositories

Choose the repositories you want to turn into components. In Portal mode:
  • Each repository becomes exactly one component (1:1 mapping)
  • Any existing catalog-info.yaml files are ignored
  • Portal will attempt to detect metadata from the repository
Portal shows all repositories from the organizations you selected in Step 3, regardless of whether they have a catalog-info.yaml file.

Step 5: Fill Missing Details (Optional)

Portal auto-detects what it can from your repositories, but some information may be missing. This step is optional. You can:
  • Fill in details now for complete metadata
  • Skip and update later through the Portal UI
Catalog Builder Missing
Steps

Step 6: Review and Complete

Review your selected components before finalizing. This screen shows:
  • All components that will be created
  • Their metadata (name, owner, lifecycle, type)
  • Any warnings or missing information
Click Complete to finish the ingestion.

What Happens Next

When you complete the workflow:
  1. Components are immediately registered in the catalog
  2. They appear in Portal within 1-2 minutes
  3. All metadata is stored in Portal’s database
You can now:

Managing Your Components

Since these components are managed by Portal:
  • Updates are made using the edit and bulk edit dialogs, not by editing files
  • Metadata lives in Portal’s database, not in your repositories
  • No catalog-info.yaml files will be created or used
Need to switch to YAML management later? See the FAQ.

Troubleshooting

Having issues? Check the Troubleshooting guide for common problems and solutions.