Where can I get Users Flow?

Users Flow is a plugin for Matomo and is available for purchase on the Matomo Marketplace as a yearly subscription. While the subscription is active you will receive all updates for this plugin.

You can also get it as a hosted solution on our Matomo Analytics (formerly Piwik Analytics) Cloud.

What does Users Flow do?

It shows you a visual representation of the most popular paths your users or visitors took through your website or app. It gives you much more insights into your users by letting you analysing those paths and where along in the path they exited your site. This helps you to improve your website and increase your conversion rates and sales. It also adds additional widgets to your Matomo (Piwik) that show you how your users engage with your website or app.

Why is Users Flow important?

When you send traffic to your website, you need to know the first page a potential customer will hit, and the second page they hit and where they exit. This allows you to engineer the process that each potential customer or visitor goes through and based on this information you can optimise your website or app to improve your conversion rates, sales and revenue. Use Users Flow in combination with segments and you will understand much better how your users use your website or app.

How is the Users Flow different to the Transition report?

Transitions only shows you how often a page was viewed and where they went to after, but not at which position a page was viewed how often and how users navigated through your entire website or app over multiple steps.

Also while the transition report shows only paths for one URL, the Users Flow shows you lots of paths your users took over several pages over several steps. It also adds more features like being able to use it in Scheduled Reports and with the Matomo Mobile app which Transitions can’t do.

Where do I get more information about this plugin?

It is recommended to visit the Users Flow plugin page on the Matomo (Piwik) Marketplace as a starting point. There is also a Users Flow Guide.

Who develops & maintains the Users Flow plugin?

The plugin is developed and maintained by InnoCraft, the company from the makers of Matomo (Piwik). At InnoCraft, passionate product designers and engineers build and maintain the free and open source project Matomo. This ensures the highest quality and compatibility of all their plugins. As a result, popular Matomo features such as Segmentation, Scheduled reports and others will work out of the box.

What about the quality of this plugin?

This plugin is built and maintained by InnoCraft, the makers of Matomo (Piwik). This ensures that the plugin is well integrated, kept up to date and automatically tested whenever a change in Matomo core is made. By purchasing this plugin you also support the original developers of Matomo to maintain the free and open source analytics platform itself.

What are the reasons the proceeding visits may not match the visit count of the next interaction?

The proceeding number of visits may not be the same as the number of visits shown for the next interaction due to a limitation in Matomo. If you use for example the events or the content tracking feature, then the number of visits may not be the same. For example, this may happen when the user performed an event as the second step, but not an actual page view.

(In Matomo 4 this behaviour may be changed.)

Does Users Flow work as a standalone product?

No, Users Flow is a plugin that is built on top of Matomo (Piwik). To use it, you first need to install Matomo.
Matomo requires PHP, a MySQL database and a webserver like Apache or Nginx. Learn more about Matomo.
Alternatively, to take away the hassle of installing and maintaining your own Matomo, signup to our Matomo Cloud (formerly Piwik Cloud) service.

Which Matomo version is required for this plugin?

You need at least Matomo (Piwik) 3 or newer. You can also signup to our Matomo Cloud (formerly Piwik Cloud) service.

Which analytics reports are provided by Users Flow?

Users Flow adds several new reports and widgets to your Matomo:

  • Users Flow report that visualises how your users navigate through your website or app. Multiple options let you dig deeper into several reports from there
  • The Top Paths report shows you which paths were used most across all interaction steps
  • The Overview report lets you explore the steps your users took in a tabular way

On top, popular Matomo (Piwik) features are supported:

Does Users Flow work on page URLs and page titles?

Yes, all visualizations and reports can be viewed for page URLs and page titles. This is useful when for example all your URLs are the same, but the page titles are different.

In Users Flow, how do I see which pages were grouped together into “Others” and where they went to from there?

In the Users Flow visualization click on an “Others” node (the green rectangular box that says “Others”) and then select “Show details”.

Can I see all users interactions and where they proceeded to in a tabular form?

Yes, you can either add the “Users Flow – Overview” widget to one of your dashboards or you can click on an “Interaction” title in the Users Flow visualization.

Why is it not possible to explore the traffic on some pages?

The “Explore traffic” feature currently only works for “day”, “week”, “month” and “range” periods but not for “years” because it would maybe need to aggregate too much data on demand. If you still want to explore traffic for a certain period, you can view that period as a range and then explore the traffic as a workaround.

Does the Users Flow report recognize internal website searches?

Yes, all internal website searches are grouped together into “Searches”.

Will the User Flow and click path reports be shown in the Matomo Mobile app for Android and iOS?

Yes, all available data for Users Flow is shown in the Matomo (Piwik) mobile app.

Does the plugin slow down tracking or require any additional storage in the log database tables?

No, the reports are generated based on existing data and does not track any additional data. It only requires some storage to persist the generated reports.

How do I view more than 10 interaction steps in the users flow visualization?

You can change the number of steps in the config/config.ini.php file by changing the value for the following setting:

UsersFlow_num_max_steps = 10

How do I view users interactions for more than 100 pages?

By default, we limit the number of pages per interaction to 100 in Users Flow.

However, you can choose to show more or less pages by changing the following configuration in the config/config.ini.php file:

 UsersFlow_num_max_rows_in_actions = 100

Why might the number of visits shown in the User Flow visualization be lower than the number of visits shown in the visitors overview?

If you have lots of different page URLs the number of visits displayed in the User Flow report might be slightly different to the number that you see in the visitors overview. By default, we look into the top 5000 interactions per step. In most cases this covers most of and user paths. You can change this number to recognize more or less interactions by changing the following configuration in the config/config.ini.php file:

UsersFlow_num_max_links_per_interaction = 5000

Setting a lower value will make the report generation faster while increasing this value will slow down the time it takes to generate this report.

Why are URL parameters not shown in the Users Flow report?

By default, we ignore URL search parameters and group all pages together that have the same path. If you prefer to see all the search parameters in the visualization report, you can enable this by going to “Administration => General Settings” as a Super User. There will be a setting for Users Flow that lets you disable this feature.

Can Users Flow be used with web server logs?

Yes, Users Flow works with Matomo (Piwik) Log Analytics.

Does Users Flow work in the Intranet?

Yes, Users Flow works with Matomo (Piwik) Intranet Analytics when you self host Matomo on premise.

Can I fetch Users Flow reports via the Matomo HTTP Reporting API?

Yes, you can request Users Flow reports in different formats such as JSON, XML, CSV and HTML to integrate the results anywhere. Read more about the Matomo (Piwik) HTTP Reporting API and view the Reporting API Reference.

Under what license is the Users Flow plugin released?

The Users Flow plugin is released under the InnoCraft EULA.