diff --git a/docs/abra/upgrade.md b/docs/abra/upgrade.md
index 1cdb506db..85e24e69f 100644
--- a/docs/abra/upgrade.md
+++ b/docs/abra/upgrade.md
@@ -75,7 +75,10 @@ abra upgrade --rc
   [`#559`](https://git.coopcloud.tech/toolshed/organising/issues/559) for
   more.
 
-* `main` will be chosen for new repositories created by `abra`.
+* `main` will be chosen for new repositories created by `abra`. `abra` will
+  also attempt to clone the `main` branch first instead of the `master` branch.
+  The `master` branch is tried afterwards. This is mainly due to the fact that
+  the majority of our recipes use the `main` branch.
 
 * `abra recipe fetch` now accepts an `--all` flag to fetch all repositories.