# Collaborative to-do lists

{!to-do-lists-intro.md!}

## Create a to-do list

{start_tabs}

{tab|via-compose-box-buttons}

{!start-composing.md!}

1. Make sure the compose box is empty.

1. Click the **Add to-do list** (<i class="zulip-icon
   zulip-icon-todo-list"></i>) icon at the bottom of the compose box.

1. Fill out todo-list information as desired, and click **Create to-do
   list** to insert todo-list formatting.

1. Click the **Send** (<i class="zulip-icon zulip-icon-send"></i>)
   button, or use a [keyboard shortcut](/help/configure-send-message-keys)
   to send your message.

!!! tip ""

    To reorder the list of todos, click and drag the **vertical dots**
    (<i class="zulip-icon zulip-icon-grip-vertical"></i>) to the left of
    each option. To delete an option, click the **delete**
    (<i class="zulip-icon zulip-icon-trash"></i>) icon to the right of it.

{tab|via-markdown}

{!start-composing.md!}

1. Make sure the compose box is empty.

1. Type `/todo` followed by a space, and the title of the to-do list.

1. _(optional)_ Type each task on a new line, with its description, if
   any, after a <kbd>:</kbd> and blank space.

1. Click the **Send** (<i class="zulip-icon zulip-icon-send"></i>)
   button, or use a [keyboard shortcut](/help/configure-send-message-keys)
   to send your message.

!!! tip ""

    You will be able to add tasks after the to-do list is created.

{end_tabs}

## Add tasks to a to-do list

{start_tabs}

1. Fill out the **New task** field, and optionally the **Description**
   field at the bottom of the to-do list.

1. Click **Add task** to add the new task to the to-do list.

{end_tabs}

## Edit the to-do list title

!!! warn ""

    Only the creator of a to-do list can edit the title.

{start_tabs}

1. Click the **pencil** (<i class="fa fa-pencil"></i>) icon
   to the right of the title.

1. Edit the title as desired.

1. Click the **checkmark** (<i class="fa fa-check"></i>) icon or press
   <kbd>Enter</kbd> to save your changes.

!!! tip ""

    You can click the <i class="fa fa-remove"></i> icon or press
    <kbd>Esc</kbd> to discard your changes.

{end_tabs}

## Examples

{!to-do-lists-examples.md!}

## Related articles

* [Message formatting](/help/format-your-message-using-markdown)
* [Polls](/help/create-a-poll)
