Create a custom dimension (classic)

Analytics classic

A custom dimension lets you send an additional parameter to Piwik PRO. In this article, we’ll show you how to set it up.

Set up a custom dimension

Before using custom dimensions you need to define them in you settings.

To add a custom dimension, follow these steps:

  1. Go to Menu > Analytics settings.
  2. Navigate to Custom Dimensions.
  3. Choose the scope for which you want to create a dimension. It can be either action or visit.
  4. Click Configure a new dimension.
  5. Name the dimension.
  6. Click Active and click Create.
  7. When you use a visit dimension, you can extract the value of the dimension from the page URL, page title or URL parameter.
  8. When you’re done, not the slot number of the custom dimension and continue the settings in Tag Manager.

Set up tracker

Now that we have a custom dimension ready we need to add it to Piwik PRO Tag that is used for tracking.

To add a custom dimension to Piwik PRO Tag, follow these steps:

  1. Go to Menu > Tag Manager.
  2. Navigate to Tags.
  3. On the left, select Piwik PRO.
  4. In Custom dimensions, click + Custom dimension.
  5. Type in the slot number of the custom dimension that you set in the settings and choose a variable or preset value that should be saved as a value.
  6. When you’re done, click Save for the tag.
  7. Click Publish to make the tag go live.

Custom dimension report

In Analytics (classic), each custom dimension report is added to the list of reports in Visitor or Action reports.


Piwik PRO offers 5 slots for each of the dimension scope. However, raising that limit is not a problem. Just contact us, and we’ll raise it to the number you want.

Was this article helpful?

Technical Support

If you have any questions, drop us a line at

We’re happy to help!