List Dialog

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:


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.


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


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


Allows the displayed items to be edited.


Specifies what string is used when the list dialog returns the selected entries.


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:


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"

List Dialog Example

Zenity list dialog example