In addition to the default publish environments, Dev, QA, and Prod, custom publish environments can be created. Learn how to enable this feature, create custom environments, and publish to them.

In this article:

Table of Contents Placeholder

How It Works

The environments that you publish to 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 have the need for more than three environments, you can create custom environments to give you more options. The name of a custom publish environment is lower-cased to create the environment portion of the URL to utag.js. For example, if you create a custom publish environment named "Stage", the URL path to the utag.js file in that environment would be: /utag/account/profile/stage/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, first you must enable the feature.

To enable custom publish environments:

  1. Click Save/Publish to open the Save dialog, then click Configure Publish Settings...​ .
  2. In the Implementation section, toggle the Custom Publish Environments button to On.
  3. 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:

  1. From the user admin menu, select Code Center.
  2. In the side panel, click +Add Environment.
  3. 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:

  1. Click Save/Publish.
  2. In the Publish To section click the new option, Custom. A Custom Environment drop-down will appear above the custom publish history area.
    iq-custom-publish-environment-save-publish.png
  3. If you have more than one custom publish environment, you must select the environment you wish to publish to from the drop-down list.
  4. Click Publish.