Publishing and Versions

Changes made to a container do not take effect on a site or mobile app until you publish the container. So, once you've added or edited tags, rules, and macros in a container, you'll need to publish the container in order to make your additions and changes live on the site/app.

To publish a container, navigate to Versions > Overview. Select a version from the table. Click Publish.

Container Versions

A version is essentially a snapshot of a container. You can save the current state of a container as a version at any time. This allows you to save and preserve your work and go back to a previous version if you need to.

Saving a version is independent of publishing. You can save versions at any time and you never need to publish a version unless you want to. However, you cannot publish a container without first saving it as a version. As a result, you'll have a saved version of anything that has been previously published. This can make it easier to recover from mistakes. For example, if someone accidentally publishes a container version before it's ready for production, you can simply publish another version that has been debugged and is known to work.

To save the current state of the container as a version, go to Container Draft > Overview in the left navigation, and click Create Version. A new version will be created with a new Container Version ID. To name the version and add notes, go to Versions > Overview and click the Version ID in the table. Click Edit to add a Container Version Name and Notes.

To publish a previously saved version of a container to the site, go to Versions > Overview in the left navigation. Click the desired version in the table, then click Publish. Google Tag Manager maintains a Publish history, so you can see when versions were live and who published them. To see the Publish history, go to Versions > Overview.

To replace the current container version with a previously saved version, go to Versions > Overview. Click the Version ID of the desired version and click the "Restore version" button (top center right of screen, next to the "Delete version" button). Restoring a container version replaces the current container draft with the content of the container version you've selected. This action does not change the published container version.