Custom Publish Environments

Custom Publish Environments

by on ‎04-21-2016 02:10 PM - edited on ‎05-14-2018 04:50 PM by Community Manager (2,990 Views)

A Custom Publish Environment is an environment you define in addition to the default environments: Dev, QA, and Prod. Tealium's publish environments should match up to your environments, with Prod matching your customer-facing Production environment, QA matching up to your QA or Staging environment, and Dev matching up to your Development environment.  Perhaps you have additional development environments, or a Pre-Production environment as a part of your process. Tealium provides Custom Publish Environments to allow flexibility when matching up these environments.

Publish environments are only needed to the extent that you have separate and distinct configurations in your iQ profiles that require testing in specific environments. Most accounts only use QA and Prod.

Table of Contents Placeholder

Enabling Custom Publish Environments

Before you can publish to a custom environment, you must enable the feature first. To do this:

  1. Click the Save_Publish_Button.png button in the upper right corner of Tealium iQ.
  2. Click the Configure_Publish_Settings_Button.png​ button in the upper right corner of the Save/Publish dialog window. This will open the Publish Configuration dialog box.
  3. Go to the Implementation section of the configurations and toggle the Custom Publish Environments button to ON. The Custom Publish Environments feature is now enabled.


Adding a Custom Publish Environment

The next step is to add a Custom Publish Environment. To do this:

  1. Click on the Save/Publish button in the upper right corner of Tealium iQ. The Save/Publish dialog window will pop up.
  2. In the Save/Publish dialog window, click the Code_Center_Button.png button. The Code Center dialog window will pop up.


  3. Click the Add_Environment_Button_.png button at the bottom left of the Code Center dialog window.
  4. 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.


    Note: You can delete a custom environment by clicking the Delete_Button.png​ button in the upper right corner of the Code Center dialog window. You will receive a prompt confirming deletion.

Publishing to a Custom Environment

You've enabled the feature and created your own custom publish environment in Tealium.  Now,  how do you publish to it? To publish to your new environment:

  1. Click the Save/Publish button.
  2. In the Publish To section you will see a new environment, labeled 'Custom'. Click it. The new Custom Environment box will highlight in blue at the bottom of the Save/Publish dialog window.
  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'. You have now published to your new custom environment.

To view your new custom environment click on the Tools tab in Web Companion then Custom Target Environments.  You can then enter the name of the custom environment and preview it on the page.

Alternatively, you can use the Environment Switcher Tealium Tool to test custom publish environments.