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

# User-defined lists

> Adding, editing, and removing user-defined lists

To get started, click the **Lists** button in the Navigator (<i class="ph ph-list-bullets" aria-hidden="true" />).

## Add user-defined list

1. Click the **Create list** button in the upper right of the screen.

2. Enter the required name of the list in the **Name** field. *(Mandatory)*

3. Optionally, type in a description of the list in the **Description** field.

4. Click **OK** to save the list.

The list is added to the **Lists** list. If you check the list in the list, the description is displayed at the top of the **Lists** screen.

As well as specifying a name and description for the list, you must [add items][1] to it.

## Edit a list's name and description

1. Select the required list from the list box at the top.

2. Click the **Edit list** button.

3. Type a new name for the list in the **Name** field.

4. Edit the description of the list, as required, in the **Description** field.

5. Click **OK** to save your changes.

## Delete user-defined list

<Note>
  You cannot delete lists that are predefined in SuperOffice CRM. If you select a predefined list, the **Delete list** button will not be displayed. Nor can you delete lists which are used in user-defined fields. In these cases, the **Delete list** button in the **Lists** tab is disabled.
</Note>

1. Select the required list from the list box at the top.

2. Click the **Delete list** button.

3. Click **Yes** in the confirmation dialog.

   The list is deleted.

[1]: ./add-items


## Related topics

- [How to create a user-defined field using the web services API](/en/api/web-services/howto/custom-objects/rest-create-udef-field.md)
- [How to get all list items](/en/api/lists/services/how-to/get-list-items.md)
- [lists](/en/api/mdo-providers/reference/lists.md)
- [How to set a user-defined list item on a Udef field (services)](/en/api/web-services/howto/custom-objects/set-udef-listitem-value.md)
- [Lists](/en/admin/lists/index.md)
- [List events](/en/automation/webhook/reference/list-events.md)