en de
Plugins Docs Request a plugin Live demo ↗ Sign in feinwerk.io ↗ Get the connector
DeleteVisitsFilter · delete · free

Remove bot traffic and junk visits from Matomo for good.

Pick websites, a date range and a Matomo segment, check the matches, then delete them, even millions of visits at once.

Install in your Matomo

Latest v2.2.1 · Matomo ≥ 5.1.0

How DeleteVisitsFilter works: check visits by segment and delete them for good
What it does for you
01

See before you delete

Check matches shows the visits per website, a sample with visitor profiles and a link to the visitor log. Nothing is deleted until you confirm.

02

Built for large clean-ups

Deletions run as jobs in small steps. Close the page and they continue in the background; very large ones run on the console without a time limit.

03

Reports stay correct

Visits are removed with all their data, with the same routine as Matomo's GDPR tool, and the affected days are processed again automatically.

1 / 8

Click to enlarge

Frequently asked questions

The GDPR tool is made for individual people: you look up a visitor and delete their data. DeleteVisitsFilter deletes every visit that matches a segment, across several websites and any date range, in one go, and keeps working in the background.

No. Deleted visits are gone for good. That is why the plugin shows the matches first, asks for confirmation and, from 10,000 visits on, asks you to type the number. Make a database backup before large deletions.

The days that contained deleted visits are marked for re-processing, including roll-ups. The next archiving run rebuilds their reports without the deleted visits.

Only super users. The history shows who started each deletion, and if the Activity Log plugin is installed, every deletion is recorded there too.

Yes. DeleteVisitsFilter is free and licensed under the GPL.

Install via the Feinwerk connector
  1. 01 Download the Feinwerk connector and unzip it into your Matomo's plugins/ directory, then activate it.
  2. 02 Open its settings and set the marketplace URL and your instance token.
  3. 03 Open the Feinwerk Plugins screen, find DeleteVisitsFilter, and click Install.
Download connector plugin

Prefer a manual install? Download the ZIP of version 2.2.1 and install it yourself. Download ZIP · Documentation for DeleteVisitsFilter

Missing a feature in DeleteVisitsFilter? Tell us what you need →

For the technically curious

DeleteVisitsFilter for Matomo

Remove bot traffic, referrer spam and test data from Matomo: choose websites, a date range and a segment, check the matches, then delete them for good.

The problem

Bots that look like real visitors, referrer spam or test traffic that slipped through: once such visits are in Matomo, they distort visits, bounce rate and conversion rates in every report. Matomo's GDPR tool can delete data, but it is made for individual people, not for thousands of visits across several websites and months.

The solution

DeleteVisitsFilter deletes every visit that matches a Matomo segment, on one website, several or all of them, in any date range. You see what will be deleted before anything happens, and large deletions keep running in the background until they are done.

Features

Choose exactly what goes

  • Websites: one website, several (also all whose name contains a text) or all websites
  • Date range: presets such as Last 30 days or Last year, or any range from the calendar, counted in each website's time zone
  • Segment: a saved segment, Matomo's segment editor or plain text with a syntax hint and a character counter
  • Any Matomo segment works, for example IP ranges, referrers, browsers or page URLs

Check before you delete

  • Check matches shows the matching visits per website and in total
  • A sample of matching visits with time, IP, browser, entry page and referrer, each with a link to the visitor profile
  • A link to the visitor log for every website, filtered by segment and date range
  • A confirmation that lists websites, date range and segment; from 10,000 visits on you type the number of visits

Built for large clean-ups

  • Deletions run as jobs in small steps, so even millions of visits do not run into timeouts
  • The progress shows the deleted visits, the current website, the speed and the estimated remaining time
  • Reload or close the page: the deletion continues in the background
  • Cancel at any time; visits deleted so far stay deleted
  • Very large deletions run on the console without a time limit

Clean data, correct reports

  • Visits are removed with all their data from Matomo's raw data tables, including those of other plugins, with the same routine as Matomo's GDPR tool
  • The affected days are marked for re-processing, including roll-ups, so the next archiving run rebuilds the reports

History

  • Every deletion with date, person, websites, segment, status, deleted visits and duration
  • Filters by status and by where a deletion was started: admin page, console or API
  • Details with the deleted rows per table
  • Use as template fills the form with an earlier deletion, Try again continues a failed one

Console and API

./console feinwerkdeletevisitsfilter:delete 1,3 "visitIp>=192.0.2.0;visitIp<=192.0.2.255" 2026-01-01 2026-09-30 --dry-run
./console feinwerkdeletevisitsfilter:work
  • Count, delete, list and cancel deletions from the command line or through the HTTP API

Fits into Matomo

  • Works in Matomo's light and dark mode
  • English and German

Technical details

Requirements

  • Matomo 5.1 or newer (5.x)
  • PHP 8.1 or newer
  • Super user access

Upgrading from DeleteVisitsFilter

Up to version 1.x this plugin was called DeleteVisitsFilter. Activate FeinwerkDeleteVisitsFilter, then uninstall DeleteVisitsFilter. Nothing needs to be migrated, and the old console command deletevisitsfilter:delete keeps working.

Related articles