> For the complete documentation index, see [llms.txt](https://docs.compliance.phalcon.blocksec.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.compliance.phalcon.blocksec.com/manual/configure/risk-engines/lists.md).

# Lists

The Lists tab provides unified management for all address lists used in risk detection. Three list types are available:

| Type               | Description                                                                                                   | Pre-created            | Editable                  |
| ------------------ | ------------------------------------------------------------------------------------------------------------- | ---------------------- | ------------------------- |
| **Blacklist**      | Addresses automatically flagged as Critical risk. All rules are bypassed.                                     | Yes (Global Blacklist) | Add/remove addresses only |
| **Whitelist**      | Addresses, entities, or categories automatically flagged as No Risk. All rules are bypassed.                  | Yes (Global Whitelist) | Add/remove subjects only  |
| **Rule Whitelist** | Exempts specific addresses, entities, or categories from specific rules. Other rules still evaluate normally. | No (user-created)      | Full control              |

<figure><img src="https://1419887533-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPfx6yOSRmp0GCnHv5rhy%2Fuploads%2Fgit-blob-8c24635088443587929a02a632d73d81344858a5%2Frisk-engine-lists-tab.png?alt=media" alt="Lists tab showing Blacklist, Whitelist, and Rule Whitelist"><figcaption></figcaption></figure>

{% hint style="info" %}
**Evaluation priority:** Blacklist / Whitelist → Rule Whitelist → Risk Engine rules. Addresses on a Blacklist or Whitelist skip all rules; Rule Whitelists only skip specified rules.
{% endhint %}

## Blacklist

The Global Blacklist is pre-created and cannot be deleted. Blacklisted addresses are automatically marked as **Critical** risk and bypass all rule evaluation.

* **Subject type**: Address only
* **Screening cost**: Blacklist matches do not consume screening credits.

Add addresses individually or import a CSV file (one address per line, with an optional second column for labels). After an import, Phalcon reports how many addresses succeeded, failed, or were skipped, and why.

## Whitelist

The Global Whitelist is pre-created and cannot be deleted. Whitelisted subjects are automatically marked as **No Risk** and bypass all rule evaluation.

* **Subject types**: Address, Entity, or Category
* **Screening cost**: Whitelist matches do not consume screening credits.

### Subject Types

* **Address** — A single on-chain address. Exact match.
* **Entity** — An entity (for example, Binance). Automatically includes all known addresses belonging to that entity.
* **Category** — A category (for example, CEX). Automatically includes all entities and their addresses in that category.

Entity and Category address sets are maintained by BlockSec's label database — you do not need to manage individual addresses. Search by category or entity name to add them.

{% hint style="info" %}
An address can appear on the Blacklist or the Whitelist, but not both. A whitelisted entity or category may still cover an address that is on your Blacklist. Phalcon does not block this — the Blacklist takes priority, so the address is still flagged as Critical.
{% endhint %}

## Rule Whitelist

Rule Whitelists let you exempt specific subjects from specific rules. Unlike the global Whitelist, a Rule Whitelist only skips the rules you specify — all other rules continue to evaluate normally.

{% hint style="warning" %}
Rule Whitelist is available on the **Scale** plan and above.
{% endhint %}

Because the remaining rules still run, addresses matched by a Rule Whitelist consume screening credits as usual.

### Create a Rule Whitelist

Creating a list takes a name and, optionally, the rules you want it to skip — you can leave the rules empty and configure them later. Subjects are not part of the creation form: once the list exists, open its detail page to add addresses, entities, and categories.

<figure><img src="https://1419887533-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPfx6yOSRmp0GCnHv5rhy%2Fuploads%2Fgit-blob-b84f5761081cb699bf2f5fe48d85c5825cdb1510%2Frisk-engine-create-rule-whitelist.png?alt=media" alt="Create Rule Whitelist dialog"><figcaption></figcaption></figure>

### Rule Whitelist Detail

The detail page has three parts:

* **Details** — List type, creation info, and subject count.
* **Rules to Skip** — The rules this whitelist bypasses, editable at any time. If a rule is deleted, it is removed from this list automatically.
* **Subjects** — The addresses, entities, and categories in this list. Search, add, import, or remove them here.

If an entity in your list no longer exists in the label database, it is shown in a greyed-out state so you can decide whether to remove it.

### How Rule Whitelists Affect Screening

When an address or transaction is screened:

* If the address (or its entity/category) is on a Rule Whitelist, the specified rules are skipped entirely — they do not appear in the screening result at all, neither as skipped nor as not triggered.
* All other rules evaluate normally.

To see which Rule Whitelists exempt a given rule, open that rule's [Rule Detail](https://docs.compliance.phalcon.blocksec.com/manual/configure/risk-engines.md#rule-detail) page.
