> ## 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.

# Updating a Plugin

> Update individual plugins or batch-update all plugins with available newer versions from the Portal Plugin Settings page.

When newer versions of your installed plugins are available, Portal will display update indicators across Plugin Settings. There are two ways to update.

<Frame>
  <img
    src="https://mintcdn.com/spotify-89f50c35/O_uASSrC5KrVagGW/portal/assets/managing-plugins/plugin-needs-update.png?fit=max&auto=format&n=O_uASSrC5KrVagGW&q=85&s=110746478d80ac6bf0bff4b9d019b9d9"
    alt="Plugin Settings showing an &#x22;Update available&#x22; indicator on a plugin
card"
    width="2264"
    height="1230"
    data-path="portal/assets/managing-plugins/plugin-needs-update.png"
  />
</Frame>

## 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

<Frame>
  <img
    src="https://mintcdn.com/spotify-89f50c35/O_uASSrC5KrVagGW/portal/assets/managing-plugins/update-all-plugins-button.png?fit=max&auto=format&n=O_uASSrC5KrVagGW&q=85&s=acf5308a950e0b7c1321afa50a67ff21"
    alt="The Install updates button on the Plugin Settings
page"
    width="2264"
    height="1242"
    data-path="portal/assets/managing-plugins/update-all-plugins-button.png"
  />
</Frame>

2. In the update dialog, review the packages and versions that will be updated. You can edit the target versions if needed

<Frame>
  <img
    src="https://mintcdn.com/spotify-89f50c35/O_uASSrC5KrVagGW/portal/assets/managing-plugins/update-all-dialog.png?fit=max&auto=format&n=O_uASSrC5KrVagGW&q=85&s=824c283fa092c10f39790d3a745ad0a4"
    alt="Update dialog showing all packages to be
updated"
    width="2164"
    height="1440"
    data-path="portal/assets/managing-plugins/update-all-dialog.png"
  />
</Frame>

<Tip>
  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`).
  This is useful for pinning to a particular release or switching between
  prerelease channels. See [Plugin Versioning](./plugin-versioning) for more
  details on supported version formats.
</Tip>

3. Click **Update** to begin the update

<Frame>
  <img
    src="https://mintcdn.com/spotify-89f50c35/O_uASSrC5KrVagGW/portal/assets/managing-plugins/update-all-in-progress.png?fit=max&auto=format&n=O_uASSrC5KrVagGW&q=85&s=73ecd28fd3b4576c9bdd3adb42b5b972"
    alt="Update build in
progress"
    width="1884"
    height="1306"
    data-path="portal/assets/managing-plugins/update-all-in-progress.png"
  />
</Frame>

4. Portal will start a build process. You can monitor progress in the build dialog — see [Build Progress](./build-progress) for details

5. Once the build completes successfully, click **Finish** to return to Plugin Settings

<Frame>
  <img
    src="https://mintcdn.com/spotify-89f50c35/O_uASSrC5KrVagGW/portal/assets/managing-plugins/update-all-complete.png?fit=max&auto=format&n=O_uASSrC5KrVagGW&q=85&s=846bf112d58df79f46d4cabaae7840ff"
    alt="Update complete with Finish
button"
    width="1860"
    height="1416"
    data-path="portal/assets/managing-plugins/update-all-complete.png"
  />
</Frame>

## 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

<Frame>
  <img
    src="https://mintcdn.com/spotify-89f50c35/O_uASSrC5KrVagGW/portal/assets/managing-plugins/update-single-button.png?fit=max&auto=format&n=O_uASSrC5KrVagGW&q=85&s=a059832c7fbeba2719d66021b14387d8"
    alt="Plugin detail page showing Install updates and Uninstall
buttons"
    width="2278"
    height="1116"
    data-path="portal/assets/managing-plugins/update-single-button.png"
  />
</Frame>

2. Click **Install updates** in the top right

3. In the update dialog, review the packages and versions that will be updated. You can edit the target version if needed

<Frame>
  <img
    src="https://mintcdn.com/spotify-89f50c35/O_uASSrC5KrVagGW/portal/assets/managing-plugins/update-single-dialog.png?fit=max&auto=format&n=O_uASSrC5KrVagGW&q=85&s=788dce5f2ef0baef0a5967675502eae4"
    alt="Update dialog for a single
plugin"
    width="1792"
    height="1306"
    data-path="portal/assets/managing-plugins/update-single-dialog.png"
  />
</Frame>

4. Click **Update** to begin the update

5. Portal will start a build process. You can monitor progress in the build dialog — see [Build Progress](./build-progress) for details

6. Once the build completes successfully, click **Finish** to return to Plugin Settings

<Note>
  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.
</Note>

For details on how Portal handles versioning and update detection, see [Plugin Versioning](./plugin-versioning).
