# Analytics

{% hint style="info" %}
This feature is available from Umbraco Forms 17.3.
{% endhint %}

Umbraco Forms includes built-in analytics that provide insight into how your forms are performing. You can view submission trends over time, monitor workflow success rates, and identify which pages are driving submissions.

## Permissions

To view form analytics, you need:

* Access to the **Forms** section in the backoffice.
* The **View Entries** permission for the form.

Users will only see analytics for forms they have permission to manage.

## Accessing Analytics

There are two ways to access form analytics in the backoffice.

### From the Forms Section Menu

In the Forms section, click the **Analytics** menu item in the sidebar. This opens the analytics overview where you can browse data across all your forms.

![Analytics overview showing a submissions chart and forms table](/files/YpmDnik8JbJTc0CNpnQx)

### From a Specific Form

You can navigate directly to analytics for a specific form:

1. Go to the **Forms** section.
2. Right-click on a form or open its action menu.
3. Select **View Analytics**.

This opens the **Analytics** tab on the form workspace, showing analytics data for that form only.

{% hint style="info" %}
The Analytics tab appears as a workspace view on existing forms. It is not available when creating a new form that has not yet been saved.
{% endhint %}

## Controls

The analytics view provides controls to adjust the data displayed.

### Date Range

Use the date range picker to select the time period for the analytics data. You can choose from preset ranges such as **Last 7 days** or **Last 30 days**, or set a custom date range. You can also enable a comparison date range to compare the current period against a previous one.

![Date range picker with preset options and comparison toggle](/files/ngNEjiQr493R5PJ3vRND)

### Group By

Use the **Group by** control to change how the data is aggregated in the time-series charts:

* **Day** — shows data points for each day in the selected range.
* **Week** — groups data by week.
* **Month** — groups data by month.

## Overview Table

The overview table lists all forms you have access to with summary statistics for the selected date range. This includes entry counts, workflow counts, workflow errors, and source pages.

![Analytics overview table showing all forms with entry counts and statistics](/files/bLZTL8TVp6HDtmnHCDAX)

Click a form name to navigate to its detailed analytics view.

## Analytics Widgets

When viewing analytics for a specific form, the view displays four widgets providing different perspectives on form performance.

### Submissions

A time-series chart showing the number of form submissions and failed workflows over the selected date range.

![Form analytics showing the submissions chart with entries and workflow errors](/files/IMJM2ublaP1DyuNeq2jH)

### Submissions by Hour

A chart showing the distribution of form submissions across the 24 hours of the day. This helps identify peak submission times and can inform decisions about when to schedule maintenance or review submissions.

![Hourly distribution chart and workflow statistics table](/files/VSKBhgA4E1MAmZrq0pJE)

### Workflow Statistics

A table listing each workflow attached to the form. It shows the number of times each workflow was triggered, succeeded, and failed. Use this to monitor the health of your form processing workflows.

### Origins

A time-series chart showing form submissions broken down by the page where the form was submitted. This is useful when the same form is placed on multiple pages across your site, as it shows which pages are driving the most submissions.

Below the chart, a table lists each source page with its name, URL, and entry count.

![Origins chart and table showing submissions by source page](/files/twxW6gkagaibiMNY1xGV)

## Data Processing

Analytics data is pre-aggregated by a background process that runs daily. This means the analytics views load quickly even for forms with a large number of submissions.

When forms are first installed or upgraded to a version that includes analytics, the background process will aggregate historical submission data. This may take some time depending on the volume of existing records.

{% hint style="info" %}
The analytics data processing is enabled by default. It can be configured or disabled via the `AnalyticsProcessing` settings in `appsettings.json`. For more details, see the [Configuration](/umbraco-forms/developer/configuration.md) article.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.umbraco.com/umbraco-forms/editor/analytics.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.