Docs menuExclusion fields for users, capabilities, user agents and languages

Exclusion fields for users, capabilities, user agents and languages

Four exclusion fields keep specific users, capability holders, uptime monitors and browser languages out of your numbers.

On this page

Besides IP addresses, paths and countries, Settings, Tracking, Exclusions has four more fields. Each takes one entry per line, applies to pageviews, events and speed measurements, and is included in settings backups. Click “Save settings” and the rule applies from then on. Nothing already counted is removed.

Excluded users

One username or user ID per line:

jane
42

These people aren’t counted while they’re logged in, whatever their role. Use it for one editor or contractor without excluding the whole role. Usernames aren’t case sensitive.

Excluded capabilities

One capability per line:

edit_posts
manage_woocommerce

Logged-in people who hold any of the listed capabilities aren’t counted. This covers custom roles without ticking each one under excluded roles. Administrators hold most capabilities, so a broad one such as edit_posts excludes them too.

Excluded user agents

One piece of text per line:

MyUptimeCheck
Acme-Monitor/

A visit isn’t counted when its user agent contains any of the entries, ignoring case. Use it for your own uptime checkers and internal monitors. Letters, numbers, spaces and / : ; . , ( ) _ + - are kept in an entry, and entries are cut at 100 characters.

Excluded browser languages

One language code per line:

zh
ru
pt-BR

A visit isn’t counted when the first language its browser lists starts with an entry, so zh also covers zh-CN and zh-TW. Entries use letters and hyphens, up to 12 characters.

Limits

Each field holds up to 100 entries. Blank lines and repeats are dropped when you save.

Testing a rule

Check this visit tests your role, user and capability rules against your own login. To test a user agent against the bot filter, use the bot filter test.

See Excluding traffic for IPs, paths and countries.