Manage Versions in Matomo Tag Manager
In Matomo Tag Manager, you can save, test, publish, and restore different versions of your container configuration. Each version provides a record of changes to the tracking setup and roll back to an earlier configuration if needed.
This guide explains how to create a container version with and without publishing it to a selected environment.
Container version history
Open your Tag Manager container and navigate to Versions.
- The Versions dashboard lists all saved container versions, including their revision number, name, description, assigned environment, creation date, and creator.
- Use the search field to find a specific version. The Actions column provides options to publish a version to an environment, debug, export its configuration, or edit its details.
- You can also identify which versions are currently published to Dev, Staging, or Live.
- Only superusers can delete versions.
Create a new version without publishing
If you want to retain your current container configuration without publishing it, you can save a new container version. For example, you want to keep the current state of the configuration before making further changes to it.
- To create a version, open your Tag Manager container.
- Navigate to Publish and provide a version name and description to explain the saved configuration.
- Click Create New Version (Without Publishing) and a snapshot of the container configuration is created and visible in the version history.
What is the difference between a draft and a saved version?
The Draft is the working configuration of your container, where you create and edit tags, triggers, and variables. Changes to the draft do not update previously saved versions.
A saved version is a snapshot of the container configuration at the time it was created. It remains available in the version history, even as you continue making changes to the draft. Learn more about working with the draft version of a container.
Create a new version and publish a release
When your container configuration is ready for testing or deployment, create a new version and publish it to a selected environment.
- Open your Tag Manager container.
- Navigate to Publish and provide a version name and description to explain the new/updated configuration.
- Scroll down to the Environment dropdown and select the relevant environment.
- Matomo Tag Manager provides three default environments:
- Dev: For development and initial testing.
- Staging: For testing and verifying your tracking configuration before going live.
- Live: For publishing your tracking configuration to your live website.
- Superusers can also configure custom environments.
- Click Create New Version and Publish Release.
Matomo creates a new container version and publishes it to the selected environment.
For example, you can publish a version to Staging to verify that your tags work as expected, then publish to Live when testing complete. A new version will be created.
Restore or transfer container configurations
Container versions allow you to roll back to a previous tracking configuration without manually recreating tags, triggers, and variables.
- Open your Tag Manager container.
- Navigate to Versions and locate the version you want to use.
- Click the rocket icon in the Actions column and in the next modal, select the environment that you want to publish it to.
- Matomo republishes the container to the selected environment without creating a new version.
You can also import and export containers to transfer configurations or preserve a copy of your setup.