From 1bb29d6f8de3926883ce5c99b370a61958510780 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Fri, 3 Apr 2026 11:38:38 +0000
Subject: [PATCH] Add environment variable naming rules to docs

Generated-By: mintlify-agent
---
 variables/environment-variables.mdx        | 4 ++++
 variables/global-environment-variables.mdx | 4 ++++
 2 files changed, 8 insertions(+)

diff --git a/variables/environment-variables.mdx b/variables/environment-variables.mdx
index 309f43e0..7c93f307 100644
--- a/variables/environment-variables.mdx
+++ b/variables/environment-variables.mdx
@@ -14,6 +14,10 @@ Environment variables are variables that are scoped to an environment, such as l
 3. Add your variable name and value for the specific environment.
 4. Save your changes.
 
+<Warning>
+  Variable names can only contain letters, numbers, underscores (`_`), hyphens (`-`), and dots (`.`). Names with spaces or special characters are not allowed and will be rejected on save.
+</Warning>
+
 ![No-Environment](/images/screenshots/variables/collection-environment.webp)
 
 ## Using an Environment Variable
diff --git a/variables/global-environment-variables.mdx b/variables/global-environment-variables.mdx
index 2df6ae53..bb220f63 100644
--- a/variables/global-environment-variables.mdx
+++ b/variables/global-environment-variables.mdx
@@ -66,6 +66,10 @@ In earlier versions, global environments are stored in Bruno's application data
 
 6. Click **Save**.
 
+<Warning>
+  Variable names can only contain letters, numbers, underscores (`_`), hyphens (`-`), and dots (`.`). Names with spaces or special characters are not allowed and will be rejected on save.
+</Warning>
+
 Your global environment variable is now created and can be accessed across your workspace.
 
 <Warning>