How to configure Matomo Tag Manager with CookieHub

With CookieHub, you can easily configure Matomo Tag Manager to comply with GDPR, CCPA, and other privacy regulations. This guide explains how to implement CookieHub and configure your Matomo tags to respect user consent.

Step 1: Implement CookieHub

CookieHub does not need to be implemented through Matomo for the integration to work. If you have already installed CookieHub using another method (such as manual HTML or Google Tag Manager), you can skip this step.

To install CookieHub through Matomo Tag Manager:

  1. Log in to your Matomo portal and open the Tag Manager section.

  2. Go to Tags and click Create a new tag.

  3. Select Custom HTML as the tag type.

  4. Name the tag (e.g., CookieHub Implementation).
  5. Paste the following script, replacing XXXXXXXX with your CookieHub Domain Code:
<!-- CookieHub -->
<script>
    var script = document.createElement('script');
    script.src = "https://cdn.cookiehub.eu/c2/XXXXXXXX.js";
    script.onload = function() {
        var cpm = {};
        window.cookiehub.load(cpm);
    };
    document.head.appendChild(script);
</script>
<!-- End CookieHub -->
  1. For Position, select Head Start.

  2. In the Configure when the tag should do this section, choose the Page View trigger and set it to Execute when any of these triggers are triggered.

  3. Click CREATE NEW TAG.
  4. Your CookieHub implementation tag has now been created. Once the changes have been published in Matomo, your CookieHub banner will appear.

Step 2: Configure Matomo tags to honor user consent

CookieHub publishes events when consent is given or when it loads with previously saved consent. To ensure Matomo tags only fire when the user has given consent, you must create custom event triggers in Matomo.

Create triggers for the events:

  • cookiehub_analytics – fires when the Analytics category is allowed.
  • cookiehub_marketing – fires when the Marketing category is allowed.

Create a custom trigger in Matomo:

  1. Go to Triggers in your Matomo Tag Manager container.

  2. Click Create a new trigger.

  3. Choose Custom Event as the trigger type.

  4. Name the trigger (e.g., CookieHub Analytics).

  5. In Event Name, enter: cookiehub_analytics

  6. Click CREATE NEW TRIGGER.
  7. Repeat the steps to create another trigger for Marketing using: cookiehub_marketing

Your Analytics and Marketing triggers are now ready.

Update your Matomo tags

For any tracking tags that require consent:

  • Remove the default Page View trigger.
  • Add the appropriate CookieHub trigger (e.g., CookieHub Analytics or CookieHub Marketing).

This ensures that tags only fire when the user gives consent for that category.

Important note about other tracking scripts

This only applies when CookieHub is implemented through a Matomo tag:

  • The CookieHub autoblocker does not work in this scenario because Matomo loads asynchronously, meaning other scripts might load before CookieHub is ready.
  • To prevent this, you must manually mark up external scripts using Conditional HTML tags to block them until consent is granted.