Skip to main content
Version: Next

Configuration

There are a number of options that allow you to configure the behaviour of the plugin. These are listed below, but the settings page also gives brief descriptions.

General​

Todoist API token​

The API token used to connect to Todoist. This is stored in your vault at .obsidian/todoist-token. If you synchronize your vault, I recommend that you do not sync this file for security reasons.

Auto-refresh​

Auto-refresh enabled​

When enabled, all queries will auto-refresh themselves according to the interval in the settings.

Auto-refresh interval​

This defines, in seconds, the interval between automatic refreshes. This is only used when:

  • the auto-refresh is enabled in the settings
  • the query does not define an explicit interval

Rendering​

Task fade animation​

When enabled, tasks will fade-in or fade-out when tasks are added or removed respectively. Just some eye candy if you like that.

Render date icon​

When enabled, queries will render an icon accompanying the due date.

Render project & section icon​

When enabled, queries will render an icon accompanying the project & section.

Render labels icon​

When enabled, queries will render an icon accompanying the labels.

Task creation​

Add parenthesis to page links​

When enabled, page links added to tasks created via the command will be wrapped in parenthesis. This may help identifying links if you primarily use Todoist on mobile platforms.

Add task button adds page link​

When enabled, the embedded add task button in queries will add a link to the page to the task in the specified place. This behaviour can also be disabled completely.

Advanced​

Debug logging​

When enabled, the plugin will print extra information to the Developer Tools console. You generally do not need to enable this.