From a52b4976d857ead4729f33065830781394f05eda Mon Sep 17 00:00:00 2001 From: Iury Lenon Date: Tue, 6 Jan 2026 21:10:20 +0000 Subject: [PATCH 1/2] docs: add info about specific version bump with --release Signed-off-by: Iury Lenon Signed-off-by: Iury Lenon --- docs/getting-started/keeping-backstage-updated.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/getting-started/keeping-backstage-updated.md b/docs/getting-started/keeping-backstage-updated.md index dea0cc2939..bbf6416747 100644 --- a/docs/getting-started/keeping-backstage-updated.md +++ b/docs/getting-started/keeping-backstage-updated.md @@ -43,6 +43,12 @@ 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`). + +```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. From 98174e3622d6c57064f5dc8e0ef8c2f90792d05d Mon Sep 17 00:00:00 2001 From: Iury Lenon Date: Tue, 13 Jan 2026 20:28:44 +0000 Subject: [PATCH 2/2] docs: add warning about downgrade limitations Add warning about downgrading Backstage versions Signed-off-by: Iury Lenon --- docs/getting-started/keeping-backstage-updated.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/getting-started/keeping-backstage-updated.md b/docs/getting-started/keeping-backstage-updated.md index bbf6416747..c93c5200f6 100644 --- a/docs/getting-started/keeping-backstage-updated.md +++ b/docs/getting-started/keeping-backstage-updated.md @@ -45,6 +45,10 @@ 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 ```