Custom publish environments
If you need more than the three default environments, you can create custom environments to give you more options.
How it works
The environments to which you publish a profile correspond to the URL of the Universal Tag (utag.js
) that you load on your site. The default environments correspond to the following URL paths:
- Dev -
/utag/account/profile/dev/utag.js
- QA -
/utag/account/profile/qa/utag.js
- Prod -
/utag/account/profile/prod/utag.js
If you need more than the three default environments, create a custom environment to give you another option. Custom environment names are case-sensitive in the URL for utag.js
. For example, if you create a custom environment named Preview
, the URL path to the utag.js
file in that environment would be: /utag/ACCOUNT/PROFILE/Preview/utag.js
You can also use Web Companion or the Environment Switcher Tealium Tool to test custom publish environments.
Enabling custom publish environments
Before you can create to a custom environment, you must enable the feature.
To enable custom publish environments:
- In the admin menu, click Configure Publish Settings. The Publish Configuration dialog appears.
- In the Implementation section, set the Custom Publish Environments toggle to On.
- Click Save.
The feature is now enabled.
Adding a custom publish environment
Once the feature is enabled, you can create new environments.
To create a custom publish environment:
- In the admin menu, click Code Center. The Code Center dialog appears.
- In the side panel, click +Add Environment.
- Enter the name of the new environment and click Add Environment. You may not use spaces or special characters in the name of the new environment, only numbers and letters.
You can delete a custom environment by clicking Delete in the upper-right corner of the Code Center dialog window. You will receive a prompt confirming deletion.
Publishing to a custom environment
Once you have created a custom publish environment, you can now publish to it. Permission to publish to custom environments is granted via the Publish Dev.
To publish to a custom environment:
- Click Save/Publish.
- In the Publish To section click the new option, Custom. A Custom Environment drop-down will appear above the custom publish history area.
- If you have more than one custom publish environment, you must select the environment you wish to publish to from the drop-down list.
- Click Publish.
This page was last updated: December 29, 2023