# delete-list command

The delete-list command removes a list
previously saved with a save-list command. This
command deletes a list from a specified file name, otherwise it defaults
to the pointer-file file. If no list name is
provided, the default list name, %user-ID, is deleted.

**Synonyms:** dl

## Syntax

```
delete-list {{file.reference} list.name}{(options}
```

## Parameter(s)

| options | i | Suppresses the message item deleted. |
| --- | --- | --- |

## Example(s)

Deletes the specific item `invoices`.

```
delete-list invoices
[435] item ’invoices’ deleted.
```
Deletes all the lists in the pointer-file.

```
delete-list *
```
Deletes the default list for the current user.

```
delete-list
[435] Item ’%tom’ deleted.
```

## See also

- [Active list](https://d3codex.com/definitions/active-list/)
- [compare-list command](https://d3codex.com/tcl/compare-list-command/)
- [copy-list command](https://d3codex.com/tcl/copy-list-command/)
- [edit-list command](https://d3codex.com/tcl/edit-list-command/)
- [fl command](https://d3codex.com/tcl/fl-command/)
- [get-list command](https://d3codex.com/tcl/get-list-command/)
- [list-lists macro](https://d3codex.com/tcl/list-lists-macro/)
- [pointer-file file](https://d3codex.com/systemfiles/pointer-file-file/)
- [qselect command](https://d3codex.com/tcl/qselect-command/)
- [save-list command](https://d3codex.com/tcl/save-list-command/)
- [Secondary list](https://d3codex.com/definitions/secondary-list/)
- [nselect command](https://d3codex.com/access/nselect-command/)
- [sort-list command](https://d3codex.com/tcl/sort-list-command/)

---
Source: https://d3codex.com/tcl/delete-list-command/ - part of the D3Codex reference.