Validating your setup before publishing is an essential step when using any Tag Management System (TMS). Tags can affect website behaviour, including page display and loading time, so it is important to test them before making them live.

Matomo Tag Manager provides a Preview and Debug mode, which lets you test your tags, triggers, and variables in a safe environment. Once your configuration is ready, click Preview / Debug to start testing.

matomo tag manager preview debug

You will then be notified through the dashboard that you are in the selected mode:

matomo tag manager debug enabled

Enter the URL you want to debug and press debug to start debug mode for that site.

In some cases, you will need to append ?mtmPreviewMode=YourContainerID&mtmSetDebugFlag=1 to the URL of your website to see the debug console:

matomo tag manager debug window

Every time you will perform an action that you defined as a trigger, for example, PageView, Click, Scroll, you will see it appearing on the left with the associated tag fired on the right.

The debug feature helps you identify and fix issues in your setup without requiring developer support.