If you are using a recent version of Matomo, Custom Dimensions is activated by default so you don’t need to do anything. However if you are using an older version of Matomo On-Premise or Matomo for WordPress (below 4.0) you will need to follow the relevant steps below before you can get started.


  1. Log in to your Matomo Dashboard with a Super User account.
  2. Click the Cog Icon in the Top Menu to visit your Matomo settings.
  3. Go to the Marketplace page within the Platform settings.
  4. Find the Custom Dimensions plugin and click the big green Install button.(You may need to confirm your password at this stage.)
  5. The plugin will be downloaded to your Matomo instance and you can click the big green Activate Plugin button to start using it. Note: It is also possible to activate it via the command line with the following command:
    ./console plugin:activate CustomDimensions


  1. Log in to your WordPress dashboard.
  2. Go to the Marketplace section of the Matomo Analytics menu.
  3. Download the Custom Dimensions Plugin.
  4. Tap on Add New within the WordPress Plugins menu.
  5. Click Upload Plugin and follow the prompts to upload the Custom Dimensions plugin zip that you just downloaded.
  6. Click Activate to enable the plugin with Matomo.
Previous FAQ: How do I add more than the default 5 custom dimensions?