Skip to content

Commit e6ea48d

Browse files
authored
chore(docs): cloud doc changes (automated) (#16050)
* chore(docs): automated cloud documentation update * Enhance documentation for environment variables features Clarified the search and filter functionality for environment variables and improved the explanation of system variables visibility in the backend tab. --------- Co-authored-by: shahednasser <shahednasser@users.noreply.github.com>
1 parent 142ad06 commit e6ea48d

2 files changed

Lines changed: 25 additions & 2 deletions

File tree

www/apps/cloud/app/environments/environment-variables/page.mdx

Lines changed: 24 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -60,6 +60,29 @@ These variables are automatically set by Cloud and don't need to be configured m
6060

6161
---
6262

63+
## Search and Filter Environment Variables
64+
65+
You can search and filter the environment variables using the toolbar above the environment variables table:
66+
67+
- **Search**: Enter a key name or value in the search field to filter the list in real time.
68+
- **Build / Runtime toggles**: Show only variables available at build time, only those available at runtime, or both at once.
69+
- **System Variables toggle**: Show or hide system-managed variables. System variables are hidden by default.
70+
71+
---
72+
73+
## System Environment Variables Visibility
74+
75+
In addition to the [system environment variables](#system-environment-variables) documented above, the backend tab displays all system-provided variables alongside your user-defined ones when the **System Variables** toggle is enabled. These are variables that Medusa adds to your environment, such as database URL, Redis URL, and other relevant variables.
76+
77+
System variables are visually distinguished from user-defined variables with a subtle background and muted text. Because Medusa manages those:
78+
79+
- The edit and delete actions are not available for system variables.
80+
- Secret system variables do not show the reveal (eye) icon.
81+
82+
System variables are useful to understand what variables Medusa sets for you so that you don't add them as well.
83+
84+
---
85+
6386
## Add Environment Variables on Cloud
6487

6588
To add environment variables to an environment:
@@ -179,4 +202,4 @@ A file download will start with the name `env.txt`, which contains the environme
179202

180203
You can rename the file to `.env` and use it in your local development.
181204

182-
![Export env button in the environment's settings tab](https://res.cloudinary.com/dza7lstvk/image/upload/v1767790560/Cloud/CleanShot_2026-01-07_at_14.55.48_2x_ro5bib.png)
205+
![Export env button in the environment's settings tab](https://res.cloudinary.com/dza7lstvk/image/upload/v1767790560/Cloud/CleanShot_2026-01-07_at_14.55.48_2x_ro5bib.png)

www/apps/cloud/generated/edit-dates.mjs

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ export const generatedEditDates = {
1212
"app/logs/page.mdx": "2026-05-06T11:31:50.584Z",
1313
"app/update-medusa/page.mdx": "2026-01-08T08:54:50.149Z",
1414
"app/connect-storefront/page.mdx": "2026-01-08T08:50:31.830Z",
15-
"app/environments/environment-variables/page.mdx": "2026-06-09T12:12:26.314Z",
15+
"app/environments/environment-variables/page.mdx": "2026-07-14T15:49:50.427Z",
1616
"app/environments/long-lived/page.mdx": "2026-06-18T13:40:26.814Z",
1717
"app/environments/preview/page.mdx": "2026-05-20T13:20:57.494Z",
1818
"app/faq/page.mdx": "2026-04-14T10:44:08.191Z",

0 commit comments

Comments
 (0)