---
updatedAt: 2026-03-30T08:46:42.000Z
agentTools:
  projectIndex: https://docs.checkmarble.com/llms.txt
---

# Custom lists

Represent custom data source any field types

# Introduction

Lists serve as custom data sources necessary for creating <Glossary>Rule</Glossary>. They can be utilized in multiple contexts, and their values can be managed independently of the <Glossary>Scenario</Glossary>'s lifecycle.

# Create a list

1. Go to Detection section and select the `Lists` tab

   <Image align="center" border={true} caption="Manage your lists from the Lists tab" src="https://files.readme.io/7190644281c5e5ed9f1464924fa4cf920049f9a6f8211a152a9cbe1de4d9c4c8-image.png" />
2. Click on *New list*
3. Complete the form to generate a new list :
   1. **Name**: this serves as a concise label utilized to identify the list throughout the application.
   2. **Description**:  this provides users with a reminder of the list's purpose.

# Update a list

## Update name and description

1. Go to an existing list
2. Click on the `Edit` button to edit the name or description

<Image align="center" border={true} caption="Edit your list's name and description" src="https://files.readme.io/365e2f9dcdaeb806f5aa57f07c69367b1b6dfdf33cfb61b744240f9d7f5390f0-image.png" />

<br />

## Create a list value

1. Go to the list detail
2. Click on the `+ New value` button and complete the form

## Add values from a CSV file

If you already have a list of values you would like to add to your list, you can add them by batch by uploading a CSV file:

1. Go to the list detail (screenshot above)
2. Click on the`Pick a CSV file` button and select your file, or just drag and drop your file to the area

> Your CSV file should only contain the values you want to add to the list: one column and no header.

## Delete a list value

1. Go to the list detail (screenshot above)
2. Search for the value using the input
3. Click on the delete button

   <Image align="center" alt="Search and delete a list value" border={true} caption="Search and delete a list value" src="https://files.readme.io/3061ae5394f65177d8d5f277d779c71fba8c97648caeb8677b6c4fcb1d71e0cd-Delete_item.png" />

# Delete a list

1. Go to the list detail (see capture in update section for more detail)
2. Click on the `Delete this list` red button at the bottom (see above capture)