Tracking Custom Dimensions via Matomo Tag Manager

If you are already using Matomo Tag Manager – which we recommend doing – then this is the easiest way to configure the tracking of Custom Dimensions.

1. Install & Configure Matomo Tag Manager.

2. Create Variable that captures the data you’d like to use in your Custom Dimension

   • For example, you might capture a Username with a Data Layer Variable
   • Or capture an article’s Publishing Date with a DOM Element Variable.

3. To link new Matomo Variables with a Custom Dimension, you can use the pre-configured Matomo Configuration Variable. Whilst editing your configuration, find the Custom Dimensions section and add your dimension ID number to the Index field, and your newly created variable to the Value field. Note: You can find your Custom Dimension ID on the Custom Dimensions page inside your Matomo Settings area accessed via the cog icon .

4. Save your configuration and optionally click to Preview / Debug your container.

5. If everything is worked as expected, then you can safely Publish your container.