Link Search Menu Expand Document (external link)

‘Create or edit Task’ Modal

Table of contents
  1. ‘Create or edit Task’ Modal
    1. Introduction
    2. Opening the ‘Create or edit Task’ Modal
    3. Entering values
      1. Description
      2. Priority
      3. Recurrence
      4. Dates
      5. Date abbreviations
      6. Status and Done on
    4. Finishing off


Create or Edit Modal The Tasks: Create or edit command helps you when adding or editing a task.

Opening the ‘Create or edit Task’ Modal

Use the command ‘Tasks: Create or edit task’ to launch the modal.

  • If the cursor was on an existing task, the modal will modify that task’s properties.
  • If the cursor was on a blank line, the modal will create a brand new task on that line.

Entering values


This is the text describing your task.

If you have a global filter enabled, the dialog takes care of adding it automatically.


See priority.


Here you can make the task recur, so that when it is marked as done, a new task is created, with newer dates.

See recurring tasks (repetition).


Here you can optionally give the task due, scheduled and start dates.

There is a lot of flexibility here. For example:

  • You can type in exact dates, such as 2022-11-28.
  • You can also enter parts of dates, such as 6 oct.
  • You can enter relative dates, such as today or tomorrow.

Date abbreviations

Introduced in Tasks 1.8.0.

The modal also has a few abbreviations of its own, to speed up entering of common values in the date fields.

Type in the abbreviation and then a space character, and the whole word will be entered for you.

Supported abbreviations:

Abbreviation Expanded Text
td today
tm tomorrow
yd yesterday
tw this week
nw next week
weekend sat
we sat

Status and Done on

These values cannot currently be edited in this modal.

Finishing off

To close the modal and save your edits, do one of:

  • click Apply,
  • press Return or Enter.

To close the modal and cancel your edits, do one of:

  • click or tap outside the modal,
  • click the close button at the corner of the modal (if one exists on your operating system),
  • hit the Esc key.