Skip to main content
Pre-built plugin installation is being rolled out gradually and might not be available in your instance yet. Look for the Custom Plugins tab under Admin → Plugin Settings. If the tab is not present, follow the previous installer instructions. See Switching to pre-built plugins for rollout details and help moving existing plugins.
Portal displays update indicators when newer versions or prepared revisions of your installed pre-built plugins are available. There are two ways to update. To update custom plugins, publish a new source version.
Plugin Settings showing an "Update available" indicator on a plugin card

​
Update All Plugins

To update all plugins with available updates at once:
  1. From the Plugin Settings home page, click Install updates in the top right
The Install updates button on the Plugin Settings page
  1. In the update dialog, review the packages and versions that will be updated. You can edit the target versions if needed
Update dialog showing all packages to be updated
To update to a specific version rather than the latest, edit the version field in the dialog using the @ syntax (e.g., @backstage/plugin-example@2.1.0). Use an exact stable version that is available as a pre-built plugin. See Plugin Versioning for more details on supported version formats.
  1. Click Update to begin the update
  2. Portal applies the updates and closes the dialog when the operation succeeds. Configure and test the updated plugins.

​
Update an Individual Plugin

To update a single plugin:
  1. From Plugin Settings, click on the plugin you want to update to open its detail page
Plugin detail page showing Install updates and Uninstall buttons
  1. Click Install updates in the top right
  2. In the update dialog, review the packages and versions that will be updated. You can edit the target version if needed
Update dialog for a single plugin
  1. Click Update to begin the update
  2. Portal applies the update and closes the dialog when the operation succeeds. Configure and test the updated plugin.
You can also update individual modules within a plugin. Navigate to the module’s page and click Update to update just that module independently of the rest of the plugin.
For details on how Portal handles versioning and update detection, see Plugin Versioning.

​
Using the previous installer

For packages installed with the previous installer, use the same update controls above. After you select Update, Portal starts a build. When the build completes successfully, select Finish to return to Plugin Settings.
The previous installer showing update build progress
The previous installer showing a completed update
See Switching to pre-built plugins to move existing packages to pre-built installation.