About changelog in Tag Manager

Tag Manager

Video tutorial: watch on YouTube

A changelog in Tag Manager is a place where you can find a chronologically ordered list of changes made on your website. It makes it easy for you to see which tag, trigger or variable was added, edited or deleted.

A changelog consists of snapshots that are made after you publish a website. Each snapshot is marked with a number, for example, Snapshot 5. You can also create a new snapshot manually before publishing the website. It will be then marked with a number, for example, Snapshot 5.1.

But why do you need a snapshot? Well, it is one of the most helpful tools to track and manage changes. Whenever you publish wrong setting, it will help you to quickly come back to previous settings. It will also let you import and export a snapshot to other websites. In this article, we’ll explain how to do it.

Changelog in Tag Manager in Piwik PRO

Create a snapshot manually

To create a snapshot manually, follow these steps:

  1. Go to Menu > Tag Manager.
  2. Navigate to Changelog.
  3. Click Add new snapshot
  4. The snapshot will be marked with a number, for example, Snapshot 5.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 previous settings on your website

To revert previous settings, follow these steps:

  1. Go to Menu > Tag Manager.
  2. Navigate to Changelog.
  3. On the left, click the 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.
    Changelog in Tag Manager in Piwik PRO

    Tip: Snapshot 1 is a default setup of your tracking.

Publish previous settings on your website

To publish previous settings, follow these steps:

  1. Go to Menu > Tag Manager.
  2. Navigate to Changelog.
  3. On the left, click the snapshot with settings that you want to use.
  4. Click Publish this snapshot. The changes from this snapshot will be live.
    Changelog in Tag Manager in Piwik PRO

Export settings to another website

To export settings to another website, follow these steps:

  1. Go to Menu > Tag Manager.
  2. Navigate to Changelog.
  3. On the left, click the snapshot with settings that you want to use.
  4. Click Export settings to file. The file will be saved on your hard drive as a JSON file.
    Changelog in Tag Manager in Piwik PRO
  5. After exporting the file, follow the guidelines below to import it to another website.

Import settings from another website

There are two ways to import settings from another website. You can import a published or draft version, or import 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. In the website picker, choose where you want to import settings.
    Import settings in Tag Manager in Piwik PRO
  4. Choose one of the following options: 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 overwrite all previous settings.
    Import settings in Tag Manager in Piwik PRO

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.
    Import settings in Tag Manager in Piwik PRO
  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.

Was this article helpful?

Technical support

If you still have some questions, visit our community.
There’s always someone ready to help!

Back to help center