> For the complete documentation index, see [llms.txt](https://pyzenity.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pyzenity.gitbook.io/docs/dialogs/list-dialog.md).

# List Dialog

* [Zenity Manual](broken://pages/-M9x2rOIvf_sDlA1_zX8)

 Use the --list option to create a list dialog. Zenity returns the entries in the first column of text of selected rows to standard output.

 Data for the dialog must specified column by column, row by row. Data can be provided to the dialog through standard input. Each entry must be separated by a newline character.

 If you use the --checklist or --radiolist options, each row must start with either 'TRUE' or 'FALSE'.

 The list dialog supports the following options: --column=column

Specifies the column headers that are displayed in the list dialog. You must specify a --column option for each column that you want to display in the dialog.--checklist

Specifies that the first column in the list dialog contains check boxes.--radiolist

Specifies that the first column in the list dialog contains radio boxes.--editable

Allows the displayed items to be edited. --separator=separator

Specifies what string is used when the list dialog returns the selected entries. --print-column=column

Specifies what column should be printed out upon selection. The default column is '1'. 'ALL' can be used to print out all columns in the list.

 The following example script shows how to create a list dialog:

```
        #!/bin/sh

        zenity --list \
          --title="Choose the Bugs You Wish to View" \
          --column="Bug Number" --column="Severity" --column="Description" \
            992383 Normal "GtkTreeView crashes on multiple selections" \
            293823 High "GNOME Dictionary does not handle proxy" \
            393823 Critical "Menu editing does not work in GNOME 2.0"
```

Figure 4 List Dialog Example