diff --git a/src/routes/guides/beatleader-auth/+page.svelte b/src/routes/guides/beatleader-auth/+page.svelte
index 479a23b..cd84807 100644
--- a/src/routes/guides/beatleader-auth/+page.svelte
+++ b/src/routes/guides/beatleader-auth/+page.svelte
@@ -150,6 +150,9 @@
Use the OAuth Login above; we request scp:offline_access to allow refresh without re‑prompting.
+
+ Multi‑environment setup: If you deploy to multiple environments (dev, staging, production), you must register all redirect URIs in your BeatLeader OAuth application. For example: http://localhost:5173/auth/beatleader/callback, https://staging.example.com/auth/beatleader/callback, and https://example.com/auth/beatleader/callback. The app automatically uses the correct redirect URI based on the current environment's origin.
+