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

# Custom Data Lists

Data lists allow for custom information to be stored and utilized in filters, letting you further fine-tune how specific routing cases are handled. For instance, if a scenario cannot fulfill certain product UPCs then a data list could be created that contains those UPCs. A filter could then be created with that data list applied to the "Item UPC" attribute, so that those items would not be assigned to locations in that scenario.

<Note>
  Note that changes to routing settings may not immediately take effect when processing orders. It may take up to 15 minutes for updates to be reflected in the system while the cache refreshes.
</Note>

Custom data lists are now known as "filter data lists" and are independent global entities, not defined for a specific strategy. They can be used as filters across any strategy or scenario.

### Data Lists Page

The **Filter Data Lists** page displays all existing data lists in a table. Click the **Current Site** selector in the top right to switch to a different site and view its data lists instead.

<img alt="The Filter Data List page of the UI" src="https://mintcdn.com/kibocommerce-59e68a4a/CAYPZbMvUiNqzMVQ/images/filterdatalist.png?fit=max&auto=format&n=CAYPZbMvUiNqzMVQ&q=85&s=d418c4c9a858a648690eeffc26799c98" className="dark:hidden" width="1908" height="519" data-path="images/filterdatalist.png" />

<img alt="The Filter Data List page of the UI" src="https://mintcdn.com/kibocommerce-59e68a4a/CAYPZbMvUiNqzMVQ/images/filterdatalist-1.png?fit=max&auto=format&n=CAYPZbMvUiNqzMVQ&q=85&s=220286e38da5a8030fe3c34fea6b7702" className="hidden dark:block" width="1908" height="519" data-path="images/filterdatalist-1.png" />

### Create a New Data List

To create a new data list:

1. Go to the **Filter Data Lists** page.
2. Click **Add Filter Data List**.
3. Enter a **Name** for the data list.<img src="https://mintcdn.com/kibocommerce-59e68a4a/5p2bvmH14ykLzZaY/img/add-new-data-list.png?fit=max&auto=format&n=5p2bvmH14ykLzZaY&q=85&s=cd31b150539037a74e53321617b65571" alt="The Add New Data List form" width="1147" height="748" data-path="img/add-new-data-list.png" />
4. Select the **Data Type** (Text, Number, Location, or Date) you want to use for the list values.
5. Enter an optional **Description**.
6. When initially creating a data list, its values should be provided via .CSV file upload. A template for building this file can be downloaded from the **Download Template** button.
7. Click **Save**.

### Edit Data Lists

Once a list has been created, it can be managed or edited from the Filter Data Lists page. Click the **Delete** icon in the Actions column to remove a data list entirely. If you want to delete a data list, you must first remove it from any filters it's currently used in.

To update a data list and its values instead:

1. Click the **Edit** icon in the Actions column of any list to view its configurations.
2. Edit the list's **Name** or **Description** as needed.
3. Use the action icons in the values table to modify or delete any existing fields.<img src="https://mintcdn.com/kibocommerce-59e68a4a/IIUyhCjtFT3x5IDQ/img/edit-data-list-update.png?fit=max&auto=format&n=IIUyhCjtFT3x5IDQ&q=85&s=27324f7cf7b9c86f0c42e4c647f3f8aa" alt="The editable configurations of a data list" lightAlt="The editable configurations of a data list" darkAlt="The editable configurations of a data list" width="1514" height="670" data-path="img/edit-data-list-update.png" />
4. Click **Add New Row** to define additional value:description data pairs.
5. To export the current data list as a CSV file, click the **Download as CSV** button located to the right of the **Add New Row** button
6. Click **Save Changes**.

### Export a Data List as CSV

There are two ways to export a data list:

**From within a Data List (Data List Detail Page)**

1. Open a data list by clicking the **Edit** icon in the Actions column on the Filter Data Lists page.
2. Click the **Download as CSV** button, located to the right of the **Add New Row** button.<img src="https://mintcdn.com/kibocommerce-59e68a4a/CAYPZbMvUiNqzMVQ/images/EditfilterdatalistCSVbutton.png?fit=max&auto=format&n=CAYPZbMvUiNqzMVQ&q=85&s=4ae51bf08356a29c416c0b3f3dbba1f6" alt="Download CSV button on edit data list page" width="1872" height="775" data-path="images/EditfilterdatalistCSVbutton.png" />
3. The file downloads automatically and includes the following columns:
   * **Value** — the stored value for each entry
   * **Description** — the full description for each entry (untruncated)
4. The export reflects all entries for the currently selected site.

**From the Filter Data Lists Page (List-Level Export)**

1. Navigate to the **Filter Data Lists** page.
2. In the **Actions** column of the data list you want to export, click the **Export** icon.<img src="https://mintcdn.com/kibocommerce-59e68a4a/CAYPZbMvUiNqzMVQ/images/FIlterdatalistpage.png?fit=max&auto=format&n=CAYPZbMvUiNqzMVQ&q=85&s=2443a4c3d2ff56ee71b66ca5447ebe74" alt="Download CSV on Data list page" width="1874" height="561" data-path="images/FIlterdatalistpage.png" />
3. The CSV file for that specific data list downloads automatically.
