Configuring immersive projects
Immersive project settings that apply site-wide are managed on the Global site. Individual projects can override the asset-serving behavior configured here; see Publishing and displaying immersive projects.
Global settings
To configure global immersive project settings:
- From the left navigation, under Admin, click Sites & Settings, then select the Global site.
- From the Main tab, using the following table as a reference, complete the fields as needed.
| Field | Purpose |
|---|---|
| Immersive API Secret | The HMAC key used to authenticate upload requests from a CI/CD pipeline. Leave this blank if immersive projects are only uploaded through the CMS. |
| Disable Cdn Asset Substitution | Controls how a project's static asset paths (JavaScript, CSS, images) are handled by default when no project overrides the setting. |
By default, an immersive project's relative asset paths are rewritten to absolute cloud storage URLs so browsers load them directly from the CDN. Selecting Disable Cdn Asset Substitution turns off that rewriting; instead, assets continue to route through Brightspot's redirect, and each one gets a version-specific query parameter appended so a CDN cache never serves a stale redirect after a new version is published. Rewriting to direct CDN URLs is simpler and works for most static projects, but can break JavaScript frameworks that compute asset paths at run time relative to the page's own URL.