Skip to content

Commit 278f9ae

Browse files
committed
Note about @web in asset filesystem URLs
1 parent 95b552e commit 278f9ae

File tree

2 files changed

+6
-0
lines changed

2 files changed

+6
-0
lines changed

docs/4.x/assets.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,9 @@ All filesystems support the following options:
3737
A filesystem’s **Base URL** can be set to an environment variable, or begin with an alias. [Read more](./config/README.md#control-panel-settings) about special configuration values.
3838

3939
In the screenshot above, we’re using a `@cdn` [alias](./config/README.md#aliases) so that the URL can be updated across multiple filesystems with a single change.
40+
41+
We strongly discourage using the automatically-determined `@web` alias as a **Base URL** in [local](#local-filesystems) filesystems, as it can differ between sites.
42+
Assets should generally have a single, stable URL.
4043
:::
4144

4245
### Local Filesystems

docs/5.x/reference/element-types/assets.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -44,6 +44,9 @@ All filesystems support the following options:
4444
A filesystem’s **Base URL** can be set to an environment variable, or begin with an alias. [Read more](../../configure.md#control-panel-settings) about special configuration values.
4545

4646
In the screenshot above, we’re using a `@cdn` [alias](../../configure.md#aliases) so that the URL can be updated across multiple filesystems with a single change in our general config file—or even with an environment variable, if the alias gets _its_ value from one!
47+
48+
We strongly discourage using the automatically-determined `@web` alias as a **Base URL** in [local](#local-filesystems) filesystems, as it can differ between sites.
49+
Assets should generally have a single, stable URL.
4750
:::
4851

4952
Multiple volumes can share a single filesystem, so long as they each have a unique and non-overlapping **Base Path**. If another volume is already mounted at the top level of a filesystem, that filesystem won’t be available for selection.

0 commit comments

Comments
 (0)