Merge pull request #32256 from iurylenonalves/docs/downgrade-instruction

docs: add info about specific version bump with --release
This commit is contained in:
Patrik Oldsberg
2026-02-05 00:18:49 +01:00
committed by GitHub
@@ -43,6 +43,16 @@ By default the bump command will upgrade `@backstage` packages to the latest `ma
yarn backstage-cli versions:bump --release next
```
You can also use the `--release` option to target a specific version. This is useful if you need to pin your app to a specific release or if you need to downgrade to a previous version (e.g. moving from `1.45.0` back to `1.43.0`).
:::warning
Note that downgrading across significant version gaps (e.g. 2-3 releases) may result in package mismatches or errors due to the way Backstage manages dependencies. This method is best suited for small adjustments.
:::
```bash
yarn backstage-cli versions:bump --release 1.43.0
```
If you are using other plugins you can pass in the `--pattern` option to update
more than just the `@backstage/*` dependencies.