zulip/help/collaborative-to-do-lists.md

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.

2. Click the Add to-do list () icon at the bottom of the compose box.

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

4. Click the Send () button, or use a keyboard shortcut 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 **trash**
(<i class="fa fa-trash-o"></i>) icon to the right of it.

{tab|via-markdown}

{!start-composing.md!}

1. Make sure the compose box is empty.

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

3. (optional) Type each task on a new line, with its description, if any, after a : and blank space.

4. Click the Send () button, or use a keyboard shortcut 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.

2. 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 () icon to the right of the title.

2. Edit the title as desired.

3. Click the checkmark () icon or press Enter 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
• Polls