About changelog in Tag Manager

A changelog in Tag Manager is a place where you can find a chronologically ordered list of changes for your website. It makes it easy for you to see precisely what changes — tags, triggers, and variables — have been made between each publishing of the website.

A changelog consists of snapshots — a recording of the setup at a given time. A snapshot is made after you publish a website and is marked with a number, for example, Snapshot 5. Additionally, you can create a new snapshot manually before publishing the website. It will be marked with a number, for example, Snapshot 5.1.

But why do you need a snapshot? It’s not there only to be looked at. With a snapshot, you can revert your website to previous settings, publish previous settings, export settings from another website, and import settings to another website. In this article, we’ll explain how to do it.

Create a snapshot manually

To create a snapshot manually, follow these steps:

1. Go to Menu > Tag Manager.
2. Navigate to Changelog.
3. Click + Create new snapshot.
4. The snapshot will be marked with a number, for example, Snapshot 3.1. The changes from this snapshot will be saved as a draft — they won’t be live.

Tip: You can use manual snapshots to share settings with your manager before publishing it on your website.

Revert your website to previous settings

To revert your website to previous settings, follow these steps:

1. Go to Menu > Tag Manager.
2. Navigate to Changelog.
3. From the left-hand list, pick a snapshot with settings that you want to use.
4. Click Revert to this snapshot. The changes from this snapshot will be saved as a draft — they won’t be live.

Tip: Snapshot 1 has a basic setup of a Piwik PRO tag on your website.

Publish previous settings on your website

To publish previous settings on your website, follow these steps:

1. Go to Menu > Tag Manager.
2. Navigate to Changelog.
3. From the left-hand list, pick a snapshot with settings that you want to use.
4. Click Publish this snapshot. The changes from this snapshot will be live.

Export settings to another website

Available from version 11.0.0.

To export settings to another website, follow these steps:

1. Go to Menu > Tag Manager.
2. Navigate to Changelog.
3. From the left-hand list, pick a snapshot with settings that you want to use.
4. Click Export configuration to file. The file will be saved on your hard drive as a JSON file.



5. After exporting a file, follow the guidelines below to import the file to another website.

Import settings from another website

Available from version 11.0.0.

There are two ways to import settings from another website — by importing the published or draft version, or by importing a file with a snapshot.

Import published or draft settings

To import settings from another website, follow these steps:

1. Go to Menu > Tag Manager.
2. Navigate to Settings.
3. From the website picker, pick a website from which you want to import settings.



4. Select the settings that you want to import:  Import last published snapshot or Import draft. The changes from the imported snapshot will be saved as a draft — they won’t be live. But they will replace all previous settings.

Import a file with a snapshot

To import settings from another website, follow these steps:

1. Go to Menu > Tag Manager.
2. Navigate to Settings.
3. In Import from file, click Add file.



4. Select a file from your hard drive and click OK. The changes from an imported snapshot will be saved as a draft — they won’t be live. But they will replace all previous settings.