Mouseflow allows you to easily set up custom URLs (virtual pageviews) using the Custom Tags Editor or through Google Tag Manager (GTM).

In this help article, the first (coding-free) method will be explored. If you are looking to set up virtual URLs through GTM, you may follow these steps instead.

Use cases

Virtual pageviews can be useful for single-page applications (SPA) or dynamic elements on any website that do not normally trigger a change in the page URL when clicked, such as pop-ups, sub-navigation menus, and toggles.

Creating custom URLs for these types of elements can help you explore and get a deeper understanding of user behavior by breaking down the user journey into separate steps in Recordings, Heatmaps, Funnels, and Forms.


The following guide will walk you through setting up custom URLs (virtual pageviews) using the Custom Tags Editor:

1. Enable the app "Push virtual pageview"

To be able to use this feature, your Mouseflow account owner or an administrator need to first navigate to the Apps & Integrations page and enable the integration:

Enabling this app will allow all account users with editing rights to push virtual pageviews when creating custom tags with the Custom Tag Editor.

2. Open the Custom Tags Editor

You can access the Custom Tags Editor through the Mouseflow app by navigating to the relevant section in your Website Settings:

Alternatively, you can access the Custom Tags Editor by clicking on the 'Add filters' button and selecting 'Tag' > 'Edit Custom Tags' from the top of the Recordings list, Heatmaps list, or any other Mouseflow feature page:

3. Add a new custom tag and virtual pageview

  • Click on 'Edit Custom Tags'

  • Enter the page you wish to add a virtual pageview to

  • Click on the page element you wish to push the virtual pageview based on

  • Add a 'New Tag name' that will also be the new pageview name (e.g. monthly)

  • Make sure the 'Click' trigger and 'Current page' options are selected

  • Open the 'Advanced settings' and check the box 'Push new pageview'

  • Click 'Add' to create the new tag and virtual pageview

  • Click 'I understand' in the warning modal shown immediately after

  • Repeat all the above steps to add more tags and virtual pageviews (optional)

  • Click 'Save and close' to save your new tag(s) and virtual pageview(s)


  • Using this feature will change your pageview data across all Mouseflow features. Once the pageviews have been split, they cannot be merged again.

  • You are able to stop virtual pageviews from being pushed in the future by removing the custom tag associated with the pageview. Disabling the integration "Push virtual pageview" will NOT have the same effect.

Did this answer your question?