> ## Documentation Index
> Fetch the complete documentation index at: https://andcze.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Blacklist
> Block access to your store for selected countries, IP addresses, networks, and players.
The blacklist is a tool that lets you decide who can place orders in your store and who can't. You can block whole countries, individual IP addresses, provider networks, and specific player names. It's a great way to cut down on abuse, fraud, and unwanted traffic.
The blacklist blocks **placing orders**. The country a given player connects from is detected automatically — you don't need to set anything up for this. When someone on a blocked list tries to buy, they'll be stopped before the purchase is finalized.
The Blacklist panel is split into four tabs. Each one blocks access in a slightly different way.
Block access for everyone connecting from a selected country or an entire continent.
Block specific IP addresses — handy when you know the exact address of the person you want to stop.
Block an entire provider's or internet service provider's network all at once.
Block specific players by their name, no matter what address they connect from.
On each tab, right next to its name, you'll see a **small counter** showing how many entries of that type there are. That way you instantly know how many countries, IP addresses, networks, or names you currently have blocked — without opening each tab one by one.
## Blocking countries
In the **Countries** tab, you'll see the **full list of every country in the world** (240+) grouped by continent: **Europe**, **Asia**, **North America**, **South America**, **Africa**, and **Oceania**. To quickly find what you're looking for, use the search field at the top of the list.
Want to block a whole continent? Click its heading to select every country in that group in one move.
Go to the **Countries** tab in the Blacklist panel.
Use the **Search country…** field (it searches by both the country name and its two-letter code), or simply scroll through the list grouped by continent.
You can select multiple countries at once by clicking them one after another — a "checkmark" appears next to each. Want to block a whole continent? Click its heading to select all countries in that group in one move. Above the list you'll see a **Selected: N** counter showing how many countries you have selected.
In the **Reason** field you can briefly note why you're blocking these countries, e.g. "high-risk region". The same reason will be assigned to all selected countries.
Once you have your countries selected, click the **Block selected (N)** button — the number in parentheses tells you how many entries you're about to add. From that moment on, people connecting from those countries won't be able to place an order.
A continent heading shows its state in three ways: an **empty box** = no country in the group is selected, a **dash** = some countries are selected, a **checkmark** = all countries on the continent are selected. This makes it easy to spot where you have partial selections.
Blocking whole continents is a quick fix, but be careful — you might accidentally cut off real customers. It's best to block only the countries that the problems actually come from.
## Blocking IP addresses, ASN, and names
The **IP Addresses**, **ASN**, and **Names** tabs work on the same principle, so you handle them the same way. In each one you can add entries in two ways — one at a time or many at once. The toggle in the top-right corner of the add panel lets you switch modes: **Add multiple** opens a field for the whole list, and **Single** goes back to adding one entry.
Type in one IP address, ASN number, or name, give a **reason** for the block (optional), and click **Add**. You can also just press **Enter** in the field — the entry is added right away. The reason will help you later remember why a given entry ended up here.
If you want to add a longer list, switch to the **Add multiple** option and paste your entries into the large field — **one per line**. Below the button you'll see how many entries will be added. You can give a shared **reason** once for the whole list. This is handy when you already have a set ready to block.
Below the add panel there's always a short **hint** tailored to the tab — for example, for IP addresses it reminds you that you can enter an IPv4 or IPv6 address, and for ASN that you provide the number in the format `AS13335` (or just `13335`) and that it blocks the entire provider.
It's always worth entering a **reason** for each entry. After a few weeks it's hard to remember why a given address or name was blocked — a short note will save you head-scratching later. The reason can be up to 256 characters, and the blocked value itself up to 128 characters.
When adding many entries at once, the system **skips duplicates** and entries that are already on the list. When it's done, you'll see a short summary, e.g. "Added 8 entries (2 skipped)" — meaning two entries already existed or were invalid and were skipped. The rest were added normally. You can add up to **200 entries** at a time.
### What you see in the entries list
Each tab shows a table with the entries you've added. For every entry you'll see:
The blocked country (with a flag and code), IP address, network number (e.g. `AS13335`), or player name.
The note you entered when adding it. If you didn't provide one, you'll see a dash.
A **Blocking** badge (red) means the entry is active, while **Disabled** (gray) means the entry is temporarily inactive.
The date the entry was added, making it easier to tell how long ago it landed on the list.
If a given tab doesn't have any entries yet, you'll see a **"No entries"** message with a prompt to add your first one. This is normal at the start.
### Managing entries
You can do the following with each entry at any time:
The entry is active and blocking access — in the table it has a **Blocking** badge.
The entry stays on the list but doesn't block for now — handy when you want to temporarily unblock something without deleting it. In the table it then shows as **Disabled**.
The entry disappears from the list permanently. Before deleting, a confirmation prompt appears — the entry is only removed after you click **Delete**.
Instead of deleting an entry right away, you can simply **disable** it with the button next to that entry. That way you keep it "in reserve" and can turn it back on with a single click if needed.
## The "Check IP / ASN" tool
You don't always know right away whether an address is worth blocking. The **Check IP / ASN** tool, which you'll find at the top of the Blacklist panel, comes to the rescue.
Just type in an IP address or ASN number (you can also press **Enter**), and after clicking **Check** you'll see the most important details:
The exact address the query is about.
Which country the connection comes from (with a flag and code).
The number of the network the address belongs to (e.g. `AS13335`).
The name of the network the address belongs to.
The internet service provider responsible for this connection.
The approximate location of the connection.
Next to the results you'll also find **quick-block** buttons: **Block IP**, **Block country**, and **Block ASN**. With these you can add an address, country, or whole network to the blacklist in a single click, without switching to another tab — such an entry automatically gets the reason "From IP lookup".
If you check an **ASN number** that has no detailed data, you'll see a short hint that you can add it on the **ASN** tab to block the entire provider's network. When there's no information at all for a query, the message **"No data for this query"** appears — meaning the address or network couldn't be identified.
Remember: blocking an **ASN** blocks the entire provider's network, not a single person. This can affect many different users who use the same internet service provider. Use this option carefully and only when you really want to cut off all traffic from a given network.
Before you block an address permanently, check it first in the **Check IP / ASN** tool. Sometimes it turns out to be an ordinary customer on a popular network, not the person you want to block.
## Frequently asked questions
Blocking an **IP address** applies to one specific connection. Blocking an **ASN** cuts off an entire provider's network — meaning potentially many different users at once. Only use ASN when you deliberately want to stop all traffic from a given network.
That's normal. When adding many entries at once, the system skips duplicates and entries that are already on the list or are invalid. The summary shows how many entries were added and how many were skipped.
No. Just click **Disable** next to that entry. It will stay on the list as **Disabled** and stop blocking, and whenever you want, you can turn it back on with a single click.
The country is detected automatically based on the player's connection — you don't need to set anything up or enter anything for this. All you have to do is add the country to the blacklist.
Yes — in the **IP Addresses** tab you can enter a single IPv4 or IPv6 address. If you're not sure which address to enter, use the **Check IP / ASN** tool first to see the connection details.
## Best practices
* **Check first, block second** — before you block an address or network permanently, use the **Check IP / ASN** tool to make sure it's actually problematic traffic and not just an ordinary customer.
* **Always provide a reason** — a short note on an entry will save you from guessing later why you blocked something.
* **Disable instead of delete** — when you want to unblock something just for a moment, use **Disable**. The entry stays in reserve.
* **Be careful with ASN** — blocking an entire network can cut off many real customers. Only use it deliberately.
* **Don't block too broadly** — cutting off whole continents can be tempting, but it's easy to lose honest players in the process. Aim for specific countries and addresses that abuse actually comes from.
* **Add lists in bulk** — when you have a set of names or addresses ready, use the **Add multiple** mode instead of entering them one by one.