What does Form Analytics do?

Form Analytics tracks how your users interact with your online forms so you can optimize your forms based on actual usage data and metrics. For example how often a form was viewed, started, submitted and converted. Form Analytics also gives you insights on how your users interact with each of your form fields. Over 50 new metrics and form analytics reports will help you find out which parts in your form cause problems to your leads and customers, and which fields are unneeded.

Where can I get the Form Analytics?

Form Analytics 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.

Where do I get more information about Form Analytics plugin?

It is recommended to visit the Form Analytics website as well as the Form Analytics plugin page on the Matomo (Piwik) Marketplace for a full list of all benefits and features. Developer documentation can be found on the Developer Zone.

Who develops & maintains the Form Analytics plugin?

The plugin is developed and maintained by InnoCraft, the company from the makers of Matomo (Piwik). At InnoCraft, talented and 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, Row evolution, Scheduled reports and others work out of the box.

What about the quality of the Form Analytics 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 developers of Matomo to maintain the free and open source analytics platform itself.

Does Form Analytics work as a standalone product?

No, the Form Analytics plugin 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 Form Analytics plugin?

Matomo (Piwik) 3.0.2 or newer is required. You can also signup to our Matomo Cloud (formerly Piwik Cloud) service.

Which browsers are supported and measured by Form Analytics?

Form Analytics has been tested with several browsers and operating systems. It supports Internet Explorer 8+ and other browsers like Chrome, Chromium, Edge, Safari, Firefox, Opera, Yandex, and mobile browsers. Please let us know if you need support for Internet Explorer 7 or older.

What does Form Analytics look like?

You can find screenshots of the UI in the plugin preview.

There is also a video showing you some of the features:

Which metrics do I get out of Form Analytics?

Form Analytics adds over 50 new metrics to your Matomo to give you all insights you possibly need to optimize your forms and increase your conversions. Some of the form analytics metrics are:

  • How often was a form viewed and by how many viewers.
  • How often was a form started after viewing a form.
  • How often was a form submitted and re-submitted.
  • How often was a form successfully completed (converted).
  • How long visitors hesitated (waited) before they started filling out a form.
  • How much time users spent on each form and long it took to submit or convert a form.

Form Analytics also reports various metrics about form fields such as:

  • How often was a form field interacted with (eg. focus or change).
  • Which fields did your visitors interact with first when they started filling out a form.
  • Which fields caused a visitor to stop filling out a form (drop offs).
  • How often your visitors changed a form field or made amendments.
  • How often a field was refocused or corrected (eg usage of backspace or delete key, cursor keys, …).
  • How much text they type into each of your text fields.
  • Which fields are unneeded and often left blank.
  • How long visitors hesitated (waited) before they started changing a field.
  • How much time your visitors spent on each field.

These are only some of the metrics you get from Form Analytics! Along with many insightful form reports.

All the metrics and reports provided by Matomo Analytics (formerly Piwik Analytics) are listed in the glossary.

Which analytics reports are provided by the Form Analytics product?

Forms Analytics adds many new reports to your Matomo Analytics (formerly Piwik Analytics). Reports are separated in several sections, depending on whether they are real-time or whether they are regular reports based on a selected date or date range.

Some of the real-time reports include:

  • Overall form usage in the last 30 minutes, 60 minutes and 24 hours.
  • Most popular forms in the last 30 minutes, 60 minutes and 24 hours.
  • With segments it is also possible to view your visitors in real-time as well as the real-time map

The following analytics reports can be displayed for any given date range:

  • Form usage by page URL to see whether the same form is used differently on different pages.
  • Entry fields to see where they start filling out your forms.
  • Drop off fields to see where your users leave your forms.
  • Field timings report to see where your users spent the most time.
  • Field size report to see how much text your users type.
  • Most corrected fields report to learn more about where users have problems filling out your form.
  • Unneeded fields report to see which fields are often left blank.
  • Several evolution reports of all metrics to see how your forms perform over time.

On top, our popular Matomo features are supported:

Is it possible to see how my web forms are performing and converting over time (evolution)?

Yes, you can drill down into the evolution for each individual form to see how the interaction with a particular form or form field changes over time. Matomo (Piwik) lets you select the metric you are interested in and shows you the evolution of your forms usage over the last days, weeks, months or years.

Is it possible to apply segments and view form analytics report for a custom segment of my users?

Yes, Form Analytics lets you segment your audience in advanced ways. Matomo (Piwik) will let you:

  • Segment your visitors by which form they viewed.
  • Segment your visitors by which form (or any form) they started.
  • Segment your visitors by which form (or any form) they submitted.
  • Segment your visitors by which form (or any form) they converted.
  • Segment your visitors by how much time they spent on a form.

This lets you slice and dice your analytics reports exactly how you need to extract valuable insights into your form viewers. You can also apply any of the over 100 Matomo segments to form reports.

Can I export Form Analytics reports and embed them somewhere else?

Yes, you can export all Form Analytics Real-Time reports and embed them via an iframe into
a different website or app
. You can also get the reports sent by email to you or your colleagues and customers. If you need access to the raw data, you can use the Live API or directly access the raw data in your MySQL database.

Will the form analytics reports be shown in the Matomo Mobile app for Android and iOS?

Yes, the form reports will be shown in the Matomo (Piwik) mobile app. Only the field reports are not yet supported by the mobile app.

How do I get the name or ID of a form?

When you create or edit a form in Matomo (Piwik), you can specify which of your online forms should be tracked into a Matomo form. You can do this by specifying one or multiple form names and form IDs in Matomo.

To find the « name » or « id » of one of your online forms, open the web page that includes this form. Then right click in the area where your form is displayed and select « Inspect element » from the context menu. Now you will see some HTML markup which defines how your web page is supposed to be displayed.

You now need to find the closest text that looks like this element: <form ***>. It may look like <form name="theFormName"> (where the form name is theFormName) or <form id="theFormID"> (where the form ID is theFormID). Sometimes you also find other attributes like method="" or action="". You can ignore these and instead focus on the value in the quotes for « id » and « name ».

Does Matomo log or track any (sensitive) data or text entered by users in my forms?

No, Matomo (Piwik) does not track or record any actual text that is entered by your users. It only tracks how they interact with your forms and form fields. Also with Form Analytics for Matomo you own the data, and nobody else can access your data. No data is shared with a third party.

Is it complicated to setup the tracking of online forms?

No, in most cases everything works out of the box. You don’t even have to change the tracking code. Matomo (Piwik) will automatically discover your forms and starts measuring how visitors use them. For Matomo to detect when one of your forms is converted, it is recommended to specify when a form should be counted as converted, by going to « Administration => Forms ». There you will also be able to change the display name for a form (used in all form reports and in segments) and more. To learn all details about the tracking of forms, check out our Form Analytics developer guide.

Matomo creates and tracks all of my web forms automatically, how do I disable this feature and manage my forms manually?

Go to « Administration => General Settings ». There will be a setting under « Form Analytics » to disable the automatic creation of forms in Matomo (Piwik).

How do I track forms that do not have a form name or form id?

When you create a form as usual by going to « Administration => Forms », you can enable the matching of a form my page URL, page path or page search query. To track a form from a certain page, click the checkbox « Track interactions in this form for forms found on specific pages, as configured below (not recommended) ». Then only specify page criteria (step 2) in « Track interactions in this form only for forms found on any of these pages (optional) ».

How do I restrict the tracking of an online form to certain pages only?

When you edit your form under « Administration => Forms », you can restrict the tracking to certain pages. This is useful when you want to measure the performance of a form only on certain pages, when you want to test and compare different forms in an A/B test (experiment) or when the same form « name » or form « id » is used on different pages but these names represent completely different forms.

How do I track many of my online forms into one form in Matomo?

When you edit your form under « Administration => Forms », you can specify an unlimited number of online forms that should be tracked into one Matomo (Piwik) form.

How do I stop the tracking of a form that Matomo has created automatically?

Imagine Matomo (Piwik) has automatically discovered a web form on your website and started to track it. Assuming you are not interested in this data, you can stop the tracking of this form by going to « Administration => Forms » and there you can « Archive » this form. When Matomo discovers this form again, it won’t be automatically created again.

If you want to apply this behaviour to all of your forms and stop the automatic creation of all forms, go to « Administration => General Settings » to disable this feature.

How do I measure form field usages for text fields, checkboxes, radio buttons, multiselect fields?

The Form Analytics plugin for Matomo (Piwik) will automatically measure your form fields which includes all the standard form field types: text input fields, textarea, checkboxes, radio buttons, multiselect fields, and more.

Your form fields will be tracked automatically and there is nothing you have to do. Learn more in the Form Analytics user guide.

How do I get started tracking my online forms?

In most cases, the plugin only needs to be installed and from there automatically collects data. In some cases you need to do additional steps. Learn more about setting up Form Analytics tracking in the developer guide.

How do I disable or ignore the tracking of individual forms?

You can exclude forms from being tracked by specifying a data-piwik-ignore attribute in your website, for example <form data-piwik-ignore action="...">.

How do I disable or ignore the tracking of individual form fields?

You can exclude form fields from being tracked by specifying a data-matomo-ignore attribute, for example <input type="text" name="my-name" data-matomo-ignore>.

How do I track my web forms which are not inside a <form> element in the HTML markup?

All you need to do is to add a data-matomo-form attribute to any element that contains all your form fields and a data-piwik-name="..." attribute to specify the name of your form. Learn more about this in the Form Analytics setup guide.

How do I disable the tracking of all forms for a specific site?

You can prevent the tracking of any form by calling _paq.push(['FormAnalytics::disableFormAnalytics']); in your website’s analytics tracking code. This is especially useful when you want to measure the usage of your online forms only for some of your websites, but not for all of them.

Does Form Analytics work with a single-page application and ajax forms?

Yes, you can execute a method _paq.push(['FormAnalytics::scanForForms']); to re-scan the page for new forms when content changes on your website or app. Read more about this in the Form Analytics API Reference, or learn more about tracking single-page application in our FAQ.

In Form reports, why are all of my form submissions zero?

Likely your form does not have a submit button or the form submit event is not triggered in your website. To record a form submit manually, call a method _paq.push(['FormAnalytics::trackFormSubmit', formOrFieldElement]); whenever your form is being submitted. formOrFieldElement can be either the form element itself or any element within your form.

In Form reports, why do I not see any form conversions?

Matomo (Piwik) differentiates between form submits and form conversions because a form may be submitted several times before all form validation errors are resolved by the user. While form submits are detected automatically, form conversions need to be either configured in the administration or triggered manually in your website or application.

To define when a form is converted, go to « Administration => Forms ». There you can specify for each form some simple rules to let Matomo know when this form is converted.

Alternatively, you can trigger a form conversion directly in your website using the method trackFormConversion. Learn more about this in the Form Analytics Developer FAQ.

Does Form Analytics support the select2 library?

select2 is a jQuery replacement for select boxes and gives you a customizable select box with support for searching, tagging, and more. Starting from Form Analytics 3.0.4 the « select2 » library is supported and tracked out of the box. In case it does not work for you, we recommend to load or embed the select2 library before you embed the Matomo (Piwik) JavaScript tracker.

Does Form Analytics support the TinyMCE editor?

Tiny MCE is a so called WYSIWYG HTML Editor. Starting from Form Analytics 3.0.4 the TinyMCE editor is supported and tracked out of the box. In case it does not work for you, we recommend to load or embed TinyMCE before you embed the Matomo (Piwik) JavaScript tracker.

Does the form tracker add a lot of data to the Matomo JavaScript tracker?

No, the Form tracker only adds a few kilobytes to your Matomo (Piwik) JavaScript tracker piwik.js. Having a small footprint and minimizing the tracker size is very important to us.

Can I fetch Form Analytics reports via the Matomo HTTP Reporting API?

Yes, all reports including the real time reports can be fetched in different formats such as JSON, XML, CSV, HTML and more, so you can integrate your measured form data anywhere. Read more about the Matomo (Piwik) HTTP Reporting API and view the Reporting API Reference.

Do I get access to the raw data that was tracked, such as forms and form fields submissions?

Yes, the raw data is accessible by using the Matomo (Piwik) Live Reporting API. Additionally if you host Matomo yourself, you get access to all data that is stored in your MySQL database: the data is stored in the matomo_log_form* tables.

Can I be alerted by email or text message when any of my form gets significantly more (or less) attention?

Thanks to our integration with the Matomo Analytics (formerly Piwik Analytics) Alerts service, you can create custom alerts and be notified whenever any of your forms will get significantly more (or less) traffic. Or you can get notified when the Total time spent on your form changes. Your imagination and requirements are the limit!

Under what license is the Form Analytics tracker released?

Form Analytics and Form Analytics tracker are released under the InnoCraft EULA.

How do I exclude employees or partners views and interactions from the form analytics reports?

See our FAQ: Excluding traffic from Matomo (Piwik) using IP Addresses, Cookies, and more.

Is there any data limit to how many forms can be tracked?

No, there is no data limit with the Form Analytics product. You can track an unlimited number of forms and form fields for unlimited visitors. Learn more about No data limit.

How Do I Track a Multi Page Form using Form Analytics?

If you have a form that is split over several pages, these forms can easily be tracked as the same form in Matomo by defining the same data-matomo-name for the form on each page.

This can be setup as follows, for example:
First Page Form:

<form data-matomo-name="multi_page_form">
    <input data-matomo-name="form_field_1" name= "field1" type="text">
    <input data-matomo-name="form_field_2" name= "field2" type="text">
    <input data-matomo-name="form_field_3" name= "field3" type="text">

Second Page Form:

<form data-matomo-name="multi_page_form">
    <input data-matomo-name="form_field_4" name= "field4" type="text">
    <input data-matomo-name="form_field_5" name= "field5" type="text">
    <input data-matomo-name="form_field_6" name= "field6" type="text">
    <input type="submit">

It is important to have unique input field names for each of the fields on all pages in your multi page form.
Please note: If you have a « Submit » button on each page of your multi page form, then each subsequent page after the first will be counted as a form re-submission.