Lists

Lists are an automatic traffic filter at redirect time. A blocklist cuts specific IPs, countries, referrers or sub ID values. An allowlist passes only what is listed. Tab: Automation → Lists.

1. Type and dimension — the Type and Dimension columns. Filters for both sit above the table.
2. Value — what is compared with the click.
3. Add to list — add one or many values at once.

Dimensions

Dimension	What is compared	Example value
Sub ID	Value of the sub_id_N parameter. The parameter name is set separately.	sub1, trash_traffic
IP address	Click IP: exact address, CIDR or mask.	192.0.2.1, 198.51.100.0/24
Referer	Referrer domain. * works as a wildcard.	spam-site.com, *.badnet.ru
Country	ISO-2 country code, case-insensitive.	RU, UA

For sub ID the parameter name is required, for example sub_id_1. Without it the entry is not saved.

How blocking works

• Entries are grouped by type, dimension and parameter name.
• Inside a blocklist, a click is blocked if it matches at least one value.
• An allowlist requires a match: a click is blocked if it matches none of the values in its group.
• Groups combine with AND: a click is blocked if any blocklist matches, or if it fails any allowlist.

What happens to a blocked click:

1. Regular flows (geo, device, A/B, rotation) are skipped.
2. Forced flows apply as usual.
3. The default flow applies. If there is none, traffic goes to the link’s main URL.
4. The click is still recorded in statistics. It is not lost.

Lists work only on links with flows

The filter applies only to links that have routing rules. A link without flows is not filtered by lists, even if its IP is on a list.

Up to 5 minutes of delay

Lists are cached in memory and refreshed every 5 minutes. A newly added value may not take effect right away.

Adding values

• Enter values one per line. The list type and dimension apply to the whole batch.
• The “Reason” field is optional. It helps you remember why something was added a month later.
• Values already on the list are skipped; the result shows how many were added and how many were skipped.
• A batch request accepts up to 500 entries.

Removing

Delete an entry with the trash icon on its row. A removed value stops blocking after the cache refresh, within 5 minutes.

Access

Owners, admins and editors add and delete entries. Viewers see the list.

API

/api/v1/lists/entries — user session (JWT) only. API keys are not allowed. The list is paginated: page and limit (max 200); search by substring of the value with search.

Related

• Routing rules — lists do nothing without flows.
• Bot filtering — automatic bot filtering, separate from lists.
• Alert rules — automatic flow shutdown based on metrics.