Projects and labels

Projects hold related tasks, and labels tag tasks across projects. This page covers making, arranging, sorting and archiving them.

On this page

In short

  • A project holds tasks, and can hold subprojects and sections.
  • Categories are optional headers that group your top-level projects.
  • Labels tag tasks across projects. Each label has its own page.
  • The project menu has every action: rename, edit, add a subproject, move, sort, share, archive and delete.
  • Drag projects to nest or reorder them, and drag tasks onto a project or label to move or tag them.
  • Each project can have its own task order.

Make a project

On the desktop Desktop

  1. Click + next to Projects in the sidebar.
  2. Type a name in the new row and press Enter.

To add a subproject, open the project's menu and choose Add subproject. In Settings, Projects, New project does the same.

On a phone Phone

Tap + on the drawer's Projects header. To make a subproject, open the project, tap the ⋮ menu and choose Add subproject.

The project menu

One menu holds the project actions, on every screen that shows a project.

  • On the desktop, open it from the ... button on a sidebar row, with a right-click, from the project page header, or from the rows in Settings, Projects. With a project focused, Shift+F10 opens it. Desktop
  • On a phone, tap ⋮ on the project screen or on the rows in Settings, Projects. Phone
ActionWhat it does
RenameRenames in place. F2 works on a focused project on the desktop.
EditOne dialog for name, parent, color and icon
Add subprojectMakes a project inside this one
Move toPuts the project under another
Move to categoryMoves a top-level project under a category header Desktop
Add category aboveMakes a new category above this project Desktop
Set as InboxMakes this project your Inbox
ReviewMarks it reviewed, and sets its review cadence or leaves it out of review
Sort tasksSets this project's task order
ShareShares the project with people. See Work with others
ArchiveHides the project without deleting it
DeleteDeletes it. It asks first when Confirm before deleting is on.

On a phone, the menu reads Edit project, Add subproject, Set as Inbox, Mark reviewed, Archive, Delete and Sort tasks. Edit project holds Shared with. Phone

A project cannot be put inside the Inbox, and the Inbox cannot be archived.

Colors and icons

Edit sets a project's color. The icon can be a folder or None. None suits names that start with an emoji, and it syncs. The sidebar, Settings and project pickers then leave the icon out so the name starts where it would.

Move and reorder projects

On the desktop Desktop

Drag a project in the sidebar or in Settings, Projects:

  • Drop on the middle of another project to nest it inside.
  • Drop on the top third of a row to place it before, and on the bottom third to place it after.
  • Drop on the PROJECTS header to make it top-level.

A move to another parent shows a message with Undo.

From the keyboard, focus a project and press Alt+Shift+Arrow (Option on a Mac) to move it up, down, into the project above, or out one level.

On a phone Phone

Hold and drag a project within its level. Screen reader users get Move up and Move down actions.

Categories

If you have many top-level projects, categories group them under named headers. They are optional. Without one, nothing changes.

  • Choose Add category above in a project's menu, or New category in Settings, Projects, to make one and name it.
  • Choose Move to category in a project's menu to file it. Or drag a project past a header.
  • Use the header's menu to rename, move up, move down or delete a category. Deleting has Undo.
  • Click a header to collapse it. That is remembered per device.

Categories sync to all your devices. Two people sharing a project each file it separately. Project pickers show the same headers.

Categories apply to top-level projects only.

Sections

Sections split a project into collapsible groups with headers and counts. Add one from the project menu, or from the strip that shows Add section between sections. A group of one has no header. On a phone, collapsed sections are remembered while the app runs.

Labels

A label is a colored tag with its own page. Chip text always stays readable against the label's color.

  • Put labels on a task in its card, or type @errand in quick add. See Quick add.
  • Open a label from Tags in the sidebar, or Labels in the phone drawer, to see all its tasks.
  • Drag a task onto a label in the sidebar to apply it. Desktop
  • On a phone, create labels from the picker. Tapping Create when a search finds nothing makes the label. Drag labels in the drawer to reorder them; the order stays on that device. Phone

Task order

A project's tasks are sorted in the project's order. The default is Due date, then manual: dated tasks first by date, then the rest in the order you drag them.

The choices are Due date, then manual, Due date, then priority, Manual, Priority, Title, Newest first and Oldest first.

Set the order

  • For one project, open its menu and choose Sort tasks. Default makes it follow its parent project again. The Inbox has a sort button in its header.
  • For all projects, open Settings, Projects, Display and use Sort project tasks by. It shows how many projects have their own order, with Reset.

A subproject follows its parent's order unless it has one of its own. The order syncs, and phone widgets follow it.

Drag to reorder

What you can drag depends on the order:

OrderWhat you can drag
ManualEvery task
Due date, then manualTasks without a date, among themselves
Any other orderNothing. A message says why.

Move a task from the keyboard Desktop

Press Alt+Shift+Up or Down on a focused task (Option+Shift on a Mac), or choose Move up or Move down in its menu. The same rule applies as for dragging. On a phone, Move up and Move down are screen reader actions. Phone

Progress rings and counts

Each project row can show a small ring of done and open tasks.

  • Show project progress in the sidebar is on by default.
  • Show task count in the sidebar adds the number of open tasks and is off until you turn it on. With both on, a row shows the ring and then the count.

Both are in Settings, Projects, Display, per device. Hidden tasks, such as the ones Vicu uses for routines, never count.

Archive and restore

Archiving hides a project but keeps it. Archived projects collect in an Archived group in the sidebar. Choose Restore on one, or Restore project on its page, to bring it back. An archived project's menu also has Delete.

Saved filters

If you used saved filters in Vikunja, Vicu turns them into custom lists. See Custom lists.

Suggest a change to this page