Troubleshooting

A task won't save

Check the task name. The name field is the only required field. If it's blank, the form will not submit.

If the name is filled in and saving still fails:

Check your internet connection — Tasks needs a live connection to persist changes.
Refresh the page and try again. A stale session can occasionally block writes.
If the error message mentions "circle", make sure you have write permission in at least one circle.

I can't find a task

Tasks can appear to go missing for a few reasons:

You're looking in the wrong view. A task only appears in the Today view if it has a deadline set to today, in This Week if the deadline is this week, and so on. Try the Active view (/tasks/active) to see all non-completed tasks regardless of deadline, or All Tasks (/tasks/all) to see everything.
Filters are hiding it. On the All Tasks page, make sure the Status filter is set to All and that the Overdue, No Deadline, and No Estimation checkboxes match what you're looking for. Use the Clear Search button to reset all filters at once.
The task is Done. Completed tasks don't appear in the Active or date-range views. Go to All Tasks and set the status filter to Done.
It belongs to a different circle. Make sure the circle you're authorized for is the one the task was created in. If you share multiple circles, all their tasks are shown together in the list views — but if you recently lost access to a circle, those tasks will no longer be visible.

A task I expected to see on the Kanban board isn't showing up

The Kanban board uses a date-range filter. By default it shows tasks whose deadline falls between today and 7 days from now.

Click the date filter at the top of the board and widen the range.
Tasks with no deadline are not shown on the Kanban board — use the Quick Tasks list for those.
The maximum range is 31 days. If your task's deadline is further out, it won't appear until the range includes it.

A collection disappeared

If a collection had a TTL (time-to-live) set, it is automatically deleted once that time expires. This is by design — TTL collections are meant to be ephemeral. Check the creation date and TTL value when you create a collection if you need it to persist indefinitely (leave TTL blank).

If you didn't set a TTL and the collection is gone, check whether someone else in your circle deleted it.

I imported a JSON file but got errors

The import validator checks the file before writing anything. Common reasons for failure:

| Error | Fix | |-------|-----| | "File is too large" | The file exceeds 512 KB. Split it into smaller files or remove large descriptions. | | "The file is not valid JSON" | Your file has a syntax error. Validate it with a JSON linter (e.g. jsonlint.com) before importing. | | "name is required" | The collection or one of its tasks is missing a name field. | | "tasks must not be empty" | The tasks array is present but empty. Add at least one task. | | "Unknown viewType" | viewType must be one of: CLASSIC, HIDE_NOW, HIDE_TOMORROW. | | "Unknown status" | Task status must be one of: WAITING, IN_PROGRESS, DONE. | | "Invalid deadline format" | Use yyyy-MM-dd format, e.g. 2025-08-01. | | "You do not have access to the selected circle" | The circle you selected during import is not in your current session. |

No partial imports occur — either everything succeeds or nothing is written.

I can't change a task's status

Status changes require write permission in the task's circle. If the status buttons are absent or disabled:

You may only have read access to that circle. Contact the circle administrator to request write access.
Guest users accessing a shared link can only view tasks, not modify them (unless the share was granted with write permission).

A task model isn't creating a collection

Creating a collection from a model requires write permission on task:collection in your default circle. If the button does nothing or returns an error:

Confirm you have at least one circle with write permission.
Make sure the model has at least one item — empty models cannot produce a collection.
If the collection name already exists in your circle, choose a different name during the creation dialog.

Shared link returns a 401 error

A shared link grants access to one specific collection. If you see a 401:

The link may have been revoked by the owner.
The session may have expired — try opening the link again from scratch.
You may be accessing a URL that was modified. Use the original link exactly as shared.

I lost access to a circle

Circle membership is managed by the circle administrator. If you can no longer see tasks or collections that were previously visible:

Ask the circle administrator to re-add you to the circle.
Check your own account settings to confirm which circles you currently belong to.