Country exclusions

Filter out traffic from specific countries across all your analytics.

Overview

Country exclusions let you permanently remove traffic from selected countries from your analytics data. This is a site-level setting — once configured, it applies everywhere:

  • Dashboard and all analytics pages
  • Audience breakdowns
  • Scheduled email reports (weekly and monthly)
  • Public API responses

The raw data is not deleted — exclusions are applied as a filter at query time. Removing an exclusion immediately restores that country's traffic in your analytics.

Setting up exclusions

  1. Navigate to your site's Settings page
  2. Scroll to the Excluded countries section
  3. Type a country name or ISO code (e.g. "United States" or "US") in the search field
  4. Click a country from the dropdown to add it to the exclusion list
  5. The exclusion saves automatically and takes effect immediately

Removing exclusions

Each excluded country is shown as a chip with a flag and name. Click the X button on any chip to remove it. Traffic from that country will reappear in your analytics immediately.

Common use cases

Filtering bot traffic

If you notice unusual traffic spikes from countries where you have no real audience, this is often automated bot traffic. Excluding those countries cleans up your visitor counts, bounce rates, and page view metrics.

Focusing on target markets

If your product only serves specific regions, exclude countries outside your target market to see cleaner metrics that reflect your actual audience.

Clean email reports

Exclusions apply to scheduled email reports too. If you send analytics summaries to clients or stakeholders, country exclusions ensure the reports only include relevant traffic.

API data hygiene

If you use the public API to pull analytics into other tools, country exclusions are applied automatically. No extra parameters needed.

How it works technically

Country exclusions are stored as an array of ISO 3166-1 alpha-2 country codes on your site record. When any analytics query runs, page views from excluded countries are filtered out at the database level before aggregation.

  • Page views with a NULL country are never excluded (they pass through)
  • Exclusions are applied per-query, not by deleting data — fully reversible
  • Adding or removing exclusions takes effect immediately with no delay
  • Only site owners and admins can modify country exclusions

Permissions

Only owners and admins can add or remove country exclusions. Team members with the viewer role can see the dashboard with exclusions applied but cannot change them.

Country exclusions vs country filter

The dashboard country filter lets you temporarily view traffic from a single country. Country exclusions are the opposite — they permanently hide traffic from selected countries. Both can be used together: you can exclude bot-heavy countries while still filtering by a specific country in your target market.