How to resolve errors when using different dimension combinations in Matomo

Matomo supports different types of dimensions, including Visit Dimensions (User-Level), Action Dimensions (Page-Level), and Event Dimensions.

Custom Reports allow you to create tailored reports using various combinations of dimensions and metrics to suit your business needs. However, not all dimension combinations are compatible. If an incompatible combination is used, you may encounter an error such as, « The current order or combination of dimensions is not compatible ».

Common Causes

  • One common issue occurs when combining dimensions that are not meant to be used together.

  • Another frequent error happens due to the order of dimensions and metrics in the report.
    matomo custom reports error

How to fix incompatible dimension combinations

  1. Try changing the order of dimensions and metrics in your report.
    matomo custom reports dimensions

  2. Ensure you are using dimensions that are logically compatible with each other.

  3. Matomo allows using two different types of dimensions in a Custom Report, but it’s always recommended to use the Preview before creating or updating the report.

Previous FAQ: How to structure Custom Reports based on User IDs, IPs, and Groups?