From 98174e3622d6c57064f5dc8e0ef8c2f90792d05d Mon Sep 17 00:00:00 2001 From: Iury Lenon Date: Tue, 13 Jan 2026 20:28:44 +0000 Subject: [PATCH] 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 ```