Use a Todoist widget on an Apple device

Add a home screen widget

1. Touch and hold anywhere on your Home Screen until your apps start to wiggle.
2. Tap the Add button on the top-left.
3. Scroll down and tap the Todoist icon.

A menu will open where you can swipe to choose the widget you want to add — Tasks, Productivity, or Add Task:

• Tasks widget: Available as a small, medium, or large widget. This widget gives you a compact overview of all tasks in a certain view, like Today or Upcoming, or a project, filter, or label.
  On iOS 17, you can complete tasks directly from the medium and large Tasks widget.
• Productivity widget: Available as a medium widget. This widget gives you an overview of your current productivity stats, like how close you are to reaching your daily or weekly goals, as well as your current Karma score.
• Add Task widget: Available as a small widget. This widget lets you open Quick Add from your iOS Home Screen, so you can quickly add a new task to Todoist.

Add a lock screen widget

If your device is running iOS 16 or above, you'll be able to add widgets to your Lock Screen.

1. Touch and hold the Lock Screen.
2. Tap Customize.
3. Tap Lock Screen.
4. Tap Add Widgets.
5. Scroll down and select Todoist.
6. Tap or drag the widget you want to add:
   • Tasks: View tasks from your task list of choice.
   • Today's Progress: Check in on today's progress.
   • Next Task: View the next upcoming task from your Today view.
   • Add Task: Add tasks quickly to Todoist.
   • Task Goal: View your daily or weekly task goals.
   • Productivity: View your productivity stats.
7. Tap the Close button.
8. Tap Done in the top-right.

If this is your first time customizing a Lock Screen on your device, you'll need to pick a wallpaper for your Lock Screen. If you've added a customized Lock Screen before, you can edit an existing Lock Screen.

If the Todoist widget doesn't appear when you swipe right on your Lock Screen, learn how to view widgets when your iPad is locked. 

1. Touch and hold the Home Screen until your apps begin to jiggle.
2. Tap the Add button at the top-right.
3. Scroll down and select Todoist.

   A menu will open where you can swipe to choose the widget you want to add — Tasks, Productivity, or Add Task:

   • Tasks widget: View tasks from your task list of choice.
     On iPadOS 17, you can complete tasks directly from the Tasks widget!
   • Add Task widget: Add tasks quickly to Todoist.
   • Productivity widget: View your productivity stats.
4. Tap Add Widget.
5. Move the widget to where you want on the Home Screen.
6. Tap Done at the top-right.

On macOS, you can only change the Todoist widget size:

1. Press ⌃ Control and click the Todoist widget.
2. Choose your preferred widget size.

Change the Task widget settings

1. Unlock your iOS device.
2. Touch and hold the Tasks widget. A context menu will pop up.
3. Tap Edit Widget.
4. Tap View.
5. Select the view you want from the menu that pops up.
6. Tap the screen outside of the widget to save your changes.

Change the Add Task widget settings

1. Unlock your iOS device.
2. Touch and hold the Tasks widget. A context menu will pop up.
3. Tap Edit Widget.
4. Tap View.
5. Enter the task name, project and section, due date, priority level, or label for any task you create with the widget.
6. Tap the screen outside of the widget to save your changes.

Follow the steps in the Apple support article to remove the Todoist widget from your desktop or Notification Center.

Remove a home screen widget

1. Touch and hold the widget to open the context menu.
2. Tap Remove Widget.
3. Tap Remove to confirm.

Remove a lock screen widget

1. Unlock your screen using Face ID or Touch ID.
2. Touch and hold the screen.
3. Tap Customize.
4. Tap Lock Screen.
5. Tap the widget you want to remove.
6. Tap the minus icon at the top-left of the widget.
7. Tap Done at the top-right to confirm.

1. Touch and hold the widget to open the context menu.
2. Tap Remove Widget.
3. Tap Remove.