How Workflowyist Works

• Todo items - Items marked as todos in Workflowy (checkbox mode) sync to your selected Todoist project
• Task content - Text changes sync both ways based on which was edited most recently
• Notes & descriptions - Workflowy notes sync to Todoist descriptions and vice versa
• Due dates & times - Sync both ways between Workflowy and Todoist
• Completion status - Completing a task in either app marks it complete in the other

Tasks are matched between platforms using special links:

• Todoist tasks get a "View in Workflowy" link in their description
• Optionally, Workflowy items can get a "View in Todoist" link in their notes

These links contain unique IDs that allow the sync to match items correctly.

Conflict Resolution

When both sides have changes, the sync uses a "last write wins" approach:

• If the Workflowy item was modified after your last sync, Workflowy's version is used
• Otherwise, Todoist's version is used

• Mirror nodes - Workflowy mirror nodes are not supported. Only the original node syncs.
• Labels/Tags - Todoist labels and Workflowy tags do not sync
• Priority - Todoist priority levels are not synced
• Deep nesting - Items sync as a flat list to Todoist
• Recurring dates - Recurring due dates may not sync correctly
• Attachments - File attachments don't sync
• Comments - Todoist comments don't sync to Workflowy
• Assignees - Task assignments in Todoist are not synced

A sync pair connects a Workflowy branch to a Todoist project. You can create multiple sync pairs to organize different areas of your life.

Example Setup

• Work - Workflowy "Work Projects" branch syncs to Todoist "Work" project
• Personal - Workflowy "Personal" branch syncs to Todoist "Personal" project
• Shopping - Workflowy "Shopping List" branch syncs to Todoist "Shopping" project

Settings Per Sync Pair

• Name - Optional friendly name for the sync pair
• Workflowy Branch - Which Workflowy node's children to sync (Home, Inbox, or any node up to 3 levels deep)
• Todoist Project - Which Todoist project to sync to
• Sync Enabled - Toggle to pause/resume syncing for this pair
• Add Todoist Links - Whether to add "View in Todoist" links to Workflowy notes

Workflowy API Key

Get your Workflowy API key from workflowy.com/api-key

Todoist API Key

Get your Todoist API key from Todoist Settings > Integrations > Developer

• Use dedicated branches - Create specific Workflowy nodes for items you want to sync rather than syncing your entire Home
• Wait for sync - After making changes, wait for the next sync cycle before expecting to see updates in the other app
• Don't delete links - The "View in Workflowy" and "View in Todoist" links are how items are matched; deleting them will cause duplicates