> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dojah.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom Lists

> Build reusable sets of values — countries, emails, phone numbers, IPs, BVNs, NINs — to block or monitor across your fraud prevention rules.

A **custom list** is a named set of values you maintain once and reference from your fraud prevention rules. Rather than repeating the same blocked country or flagged email in every rule, you keep it in one list and point your rules at the list — update the list, and every rule that uses it follows.

<Note>
  **Where lists are used.** Custom Lists are the building blocks for your fraud rules — for example, a *Blocked Countries* list or a *VPN IP Addresses* list that your **EasyDetect** rules check against. Find them under **Integrations** in the sidebar.
</Note>

## The Custom Lists table

The main view lists every custom list you’ve created. Use **Search** to find one by name, and **+ Create List** to add a new one. Click a list’s name to open it and manage its items.

<img src="https://mintcdn.com/dojah/LZxS1bz_9Y9K9GSQ/images/dashboard-guide/custom-lists.png?fit=max&auto=format&n=LZxS1bz_9Y9K9GSQ&q=85&s=ab274d6c557754a8390b61b4abfe75c0" alt="The Custom Lists table in the Dojah dashboard" width="2880" height="1800" data-path="images/dashboard-guide/custom-lists.png" />

| Column | What it shows |
| - | - |
| List Name | The name you gave the list. Click it to open the list and manage its items. |
| Items | How many entries the list currently holds. |
| Created By | The team member who created the list. |
| Date Added | When the list was created. |
| Date Updated | When an item in the list was last changed. |
| ⋮ (actions) | The three-dot menu to **Edit** or **Delete** the list. |

## Creating a list

Select **+ Create List** to open the form. Give the list a name and description, choose its **Type**, then add the values it should hold.

<img src="https://mintcdn.com/dojah/LZxS1bz_9Y9K9GSQ/images/dashboard-guide/custom-lists-create.png?fit=max&auto=format&n=LZxS1bz_9Y9K9GSQ&q=85&s=a76857bcf653a32782279d9a23b819f6" alt="The Create List form in the Dojah dashboard" width="2880" height="1800" data-path="images/dashboard-guide/custom-lists-create.png" />

| Field | What it does |
| - | - |
| List name | A label for the list, e.g. *Blocked Countries*. |
| Description | A short note on what the list is for. |
| Type | The kind of value the list holds — **Countries**, **Email**, **Phone Number**, **IP Address**, **BVN**, **NIN**, or **Others**. |
| Add items | Type a value and press **Enter** (or **Add**) to add it. Each value appears as a chip you can remove. |
| Bulk upload | Drag & drop or browse a **CSV file** to add many values at once. |

## Viewing and editing a list

Click a list’s name to open its detail view, where every entry shows as a chip. From here you can **Search items**, **Add Item**, or remove a value with the **×** on its chip. To rename a list, change its description, or delete it, use the **⋮** menu on its row in the table.

<img src="https://mintcdn.com/dojah/LZxS1bz_9Y9K9GSQ/images/dashboard-guide/custom-lists-detail.png?fit=max&auto=format&n=LZxS1bz_9Y9K9GSQ&q=85&s=cfb1153a8b19b74b19a04c34961e5ed8" alt="A custom list's items shown as removable chips" width="2880" height="1800" data-path="images/dashboard-guide/custom-lists-detail.png" />

<Warning>
  **Deleting is permanent.** Removing a list deletes it and all of its items, and the action can’t be undone. Any rule that relied on the list will no longer find it — check your fraud rules before deleting.
</Warning>

## Frequently asked questions

<AccordionGroup>
  <Accordion title="What are custom lists in Dojah?">
    A custom list is a named set of values — such as countries, emails, phone numbers, or IP addresses — that you maintain in one place and reference from your fraud prevention rules. Updating the list updates every rule that uses it, so you don’t have to edit each rule by hand.
  </Accordion>

  <Accordion title="What types of values can a custom list hold?">
    A list can hold **Countries**, **Email** addresses, **Phone Number**s, **IP Address**es, **BVN**s, **NIN**s, or **Others**. You set the type when you create the list.
  </Accordion>

  <Accordion title="How do I add many items to a list at once?">
    In the Create or Edit form, use the **bulk upload** area to drag & drop or browse a **CSV file**. You can also add values one at a time by typing each and pressing **Enter**.
  </Accordion>

  <Accordion title="Can I edit or delete a list after creating it?">
    Yes. Open the **⋮** menu on the list’s row and choose **Edit** to change its details and items, or **Delete** to remove it. Deleting is permanent — the list and all its items are removed and can’t be recovered.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.