Transitions – Analyse the previous and following actions of your visitors for each page FAQ - Reports

The Transitions feature gives you a report that shows what visitors did immediately before and after viewing a specific page. It helps you see where visitors came from and where they went next, providing valuable context for understanding user journeys. This guide explains how to access, interpret, and apply the insights from the Transitions report.

How to Open the Transitions Report for a Page?

You can launch it from the pages and page titles reports (Behaviour > Pages and Behaviour > Page Titles). When you move your mouse over a row of the table, two icons are shown. Click the icon to open Transitions for this row:

The report that is shown contains data for the period you selected in the normal date picker.

Understanding the Page Transitions Report

In the center, you see general statistics about the page you launched Transitions on.

The first number is the number of pageviews for this specific page. Hover the number to see the share of all pageviews.
You can also hover over different numbers to see the share of the groups.

On the sides of the box in the center, you see what visitors did directly before and after visiting the page in the center.

The height of the connections to the box in the center is proportional to the amount of traffic that took this route.

By default, the Transitions report shows only the top five rows per section (previous pages, following pages, and other groups). The remaining data is grouped into an Others category, both in the UI and in API responses. If you need more detailed data, you can request more results using the limitBeforeGrouping parameter with the API method.

This parameter lets you increase the number of rows returned before grouping the rest into Others. It defaults to 5 and does not support using -1. To return all rows, pass a very high value, for example:
?module=API&method=Transitions.getTransitionsForPageUrl&pageUrl=https://divezone.net/&idSite=1&period=day&date=yesterday&limitBeforeGrouping=1000&format=JSON

On the left side, you can see where users came from.

From Internal Pages means that visitors came to the page in the center from other pages on your website. This might be via links in the content or the navigation.
The group From Search Engines shows how many people came from external search engines like Google directly to the page in the center. You can click “From Search Engines” to expand the group and see the keywords that were used.
From Websites shows which external websites linked directly to the page in the center. You can also expand this group by clicking on it in order to see the links that referred visitors to the page.
There’s also a group From Campaigns which is not visible in the screenshot because there are no such referrals in the example. This group shows how many visitors triggered a campaign when entering on the page in the center.
From Internal Searches lists the keywords that your visitors searched for on your Internal Search engine, and then clicked to the page (learn more about Site Search Analytics).
The group Direct Entries shows visits that started on this page, i.e. the visitor used the page as a landing page.

The right side shows what users did after visiting the page in the center.

To Internal Pages means that visitors went to a different page on your website after their visit to the page in the center.
Internal Searches lists all the keywords that visitors started searching for, when they were on the page in the center.
When people click a download or outlink on the page, this is shown in the groups Downloads and Outlinks.
The group Exits shows visits that ended on this page, i.e. no more actions were tracked for the visitor.

The last element is the Page Reload group on the bottom. A page reload means loading the page multiple times in a row.

Using & Interacting with the Transitions Report

There are several ways you can interact with Transitions.

You can open and close groups by clicking either their title or the corresponding line in the center box.
Transitions shows you additional information about various parts in a tooltip when you move your mouse around.
You can click the pages under From Internal Pages and To Internal Pages to reload Transitions for a different page.
The current state of the popover is part of the URL. This means that you can use your browser’s back and forward buttons to navigate. Also, you can send the link to someone else and the Transitions popover will open for the page you were viewing when you copied the URL.

Conclusion

When designing Transitions, we made some deliberate choices that distinguish it from similar Clickpath features. It is not focused on the path, instead it shows the transitions through a page – hence the name. With this feature, you can see everything that happened before and after a page, not only the internal pageviews.

This information is quite hard to find in other tools so we hope you enjoy easy analytics with Matomo and have fun using Transitions!

Resources

FAQ: The numbers from Transitions don’t match other numbers shown in Matomo. Why?
FAQ: How do I make “Transitions” feature work faster on high traffic websites?
Users Flow is a visual representation of the most popular paths your users take through your website or app, which complements Transition perfectly. Here is what the Users Flow report looks like:

Matomo training videos

Want to learn how to use Matomo’s other features? Watch these free training videos below!