About debug mode

Before you publish any tag, you can check if they work correctly in debug mode. The debug mode will load your website with unpublished changes and you will be able to test how tags, triggers, and variables work.

To use debug mode, follow these steps:

  1. Go to Menu > Tag Manager.
  2. From the website picker, choose a website or app you want to work with.
  3. In the top-right corner click Debug.
  4. Click debug in Tag Manager in Piwik PRO.

    Tip: To open debug mode, you can also add ?_stg_debug at the end of your website’s URL.

  5. Your website will open in a new tab with debug mode running.
  6. Debug mode in Tag Manager.
  7. Optionally, toggle Prevent page reload. This will freeze the page, and when you click any element it won’t open a new page.
  8. Toggle prevent page reload in a debug mode.

    Tip: This option is useful for checking form submissions and button and menu-item clicks.

  9. Perform an action which you want to test and see if the tag was fired. For example, click a button.
  10. Click a button in debug mode in Tag Manager.
  11. You can also check what data are being collected when the tag is fired. In the debug mode, navigate to Events Log > stg.click (or other action) > Name of your tag > Variables. Here you will see a list of all variables that are tracked for this tag.
  12. See variables in debug mode in Tag Manager.
  13. When you’re satisfied with how the tag works, go back to Tag Manager and click Publish.
Click publish a tag in Tag Manager.

Tip: When you click Publish, Tag Manager will publish all changes in tags, triggers, and variables. So make sure, that everything is set up well before you make changes live.

Was this article helpful?

Be the first to rate this article.

Technical Support

If you have any questions, drop us a line at support_SPC@piwik_SPC.pro.

We’re happy to help!