Skip to main content
The Breakdown Report is one of the most versatile reports in Umami, allowing you to analyze your website metrics across multiple dimensions simultaneously. This report helps you understand how different segments of your traffic perform.

​
What is a Breakdown Report?

A Breakdown Report aggregates your website metrics (views, visitors, visits, bounce rate, and time on site) and breaks them down by one or more dimensions. This allows you to answer questions like:
  • Which pages get the most traffic?
  • What countries do my visitors come from?
  • Which browsers and devices are most popular?
  • How do different referrers perform?

​
Key Metrics

The Breakdown Report calculates the following metrics:

Views

Total number of page views for each dimension value

Visitors

Number of unique visitors (sessions) for each dimension value

Visits

Number of unique visits for each dimension value

Bounces

Number of single-page sessions (visits with only one page view)

​
Calculated Metrics

  • Bounce Rate: Percentage of visits that were bounces (single-page sessions)
  • Average Time: Average time spent per visit

​
Available Dimensions

You can break down your data by the following dimensions:
  • URL Path: The page path (e.g., /products, /about)
  • Referrer Path: The referrer page path
  • Query String: URL query parameters
  • Country: Visitor’s country
  • Region: Geographic region
  • City: City location
  • Browser: Web browser used (Chrome, Firefox, Safari, etc.)
  • OS: Operating system (Windows, macOS, iOS, Android, Linux)
  • Device: Device type (desktop, mobile, tablet)
  • Screen Size: Screen resolution
  • Referrer Domain: The domain that referred traffic
  • UTM Parameters: utm_source, utm_medium, utm_campaign, utm_content, utm_term

​
How to Use the Breakdown Report

1

Select Date Range

Choose the time period you want to analyze. You can select predefined ranges (last 7 days, last 30 days, etc.) or a custom date range.
2

Choose Dimensions

Select one or more fields to break down your data. You can combine multiple dimensions for deeper analysis (e.g., country + device).
3

Apply Filters (Optional)

Filter your data to focus on specific segments. For example, filter by a specific country or device type.
4

Analyze Results

Review the breakdown table showing metrics for each dimension value. Results are sorted by views and limited to the top 500 entries.

​
Use Cases and Insights

​
Analyze Page Performance

Break down by URL Path to see which pages drive the most traffic and engagement.Insights you can gain:
  • Which pages have the highest bounce rates?
  • Which pages keep visitors engaged the longest?
  • Are there pages with high traffic but low engagement?
{
  "fields": ["url_path"],
  "startDate": "2024-01-01",
  "endDate": "2024-01-31"
}

​
API Usage

You can generate Breakdown Reports programmatically using the Umami API: 
curl -X POST https://your-umami-instance.com/api/reports/breakdown \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "websiteId": "your-website-id",
    "parameters": {
      "startDate": "2024-01-01T00:00:00Z",
      "endDate": "2024-01-31T23:59:59Z",
      "fields": ["url_path", "country"]
    },
    "filters": {}
  }'
The Breakdown Report is limited to 500 results per query. Results are sorted by views in descending order.

​
Best Practices

Combine Dimensions

Combine 2-3 related dimensions for deeper insights (e.g., page + device + country)

Use Filters

Apply filters to focus on specific segments and reduce noise in your data

Compare Time Periods

Run the same breakdown for different time periods to identify trends

Monitor Bounce Rates

High bounce rates may indicate poor user experience or irrelevant traffic
Combining too many dimensions can make results difficult to interpret. Start with 1-2 dimensions and add more as needed.

​
Next Steps

Track Conversions

Use Funnel Reports to track multi-step conversions

Analyze User Journeys

See the paths users take through your site

Build docs developers (and LLMs) love

Get started for freeTalk to us