Skip to main content

Projects App

Plan your community's work in projects, with tasks on a list, board, calendar or timeline.

note

You can install and manage Root's own Apps on desktop or mobile. Apps from other developers, and Bots, are installed from Root on desktop. Once installed into a community, Apps and Bots can be used on Root desktop and mobile.

What is Projects?​

Projects is a community app for planning and tracking work. You create projects, add tasks to them, and move each task through columns until it is done. You can see the same tasks as a list, a board, a calendar or a timeline, and My Tasks shows everything assigned to you across every project.

How it works​

Projects​

A project holds a set of related tasks. Every project has a name, an icon and a short key (for example, WEB). The key starts each task's number, so the first task in WEB is WEB-1.

The Projects page lists every project you can see, with its progress, dates and status (Not started, In progress or Complete). Switch to Timeline to see all your projects side by side on a timeline.

Columns​

Columns are the steps a task moves through. New projects start with To Do, In Progress, In Review and Done. You can rename, reorder, add and delete columns in the project settings.

A done column holds finished work. Tasks in a done column count as complete for the project's progress and don't get due date reminders. Archived tasks also count as complete. To make a column a done column, turn on Done column on the Columns tab of the project settings. Done is a done column to start with.

Views​

Inside a project, switch between these views:

ViewWhat it shows
BacklogTasks that are Planned but not on the board yet, and Archived tasks.
TasksTasks on the board, as a List (the default) or a Board of columns.
CalendarTasks with a start or due date on a monthly calendar. Drag a task to change its date.
TimelineTasks with dates as bars. Drag or resize a bar to change its dates.

In Tasks, use Filter, Sort and Display to choose which tasks you see and what each one shows.

Labels and custom fields​

Labels are colored tags you can add to tasks. They are shared by every project in the community. Manage them on the Labels page.

Custom fields add extra details to every task in one project, such as a link or a number. Field types are Text, Number, Date, Select, Checkbox and URL.

Roles and permissions​

Projects uses two settings that community owners set up:

SettingWho they are
Projects AdminsFull access to every project.
Projects CreatorsCan create new projects.

Whoever creates a project can manage it.

Each project also has a Visibility section in its settings, with two lists:

  • Who can view: leave it empty so everyone in the community can see the project, or add people and roles to limit it.
  • Who can edit: the people and roles who can add and change tasks. Everyone else who can view the project can only look. People on this list can always see the project, even if they aren't under Who can view. If the list is empty, everyone who can view can edit.

A new project starts with only its creator under Who can edit. Add more people when you are ready for them to help.

Projects Admins and the project's creator can always manage the project, whatever the lists say.

What people who can view can do​

  • See the project, its tasks and comments
  • Export tasks

What people who can edit can do​

  • Create, edit, assign and archive tasks
  • Add subtasks, linked tasks, labels and comments
  • Import tasks
  • Change the project's dates

What people who manage a project can do​

  • Delete tasks
  • Change columns, custom fields and project settings
  • Change Visibility
  • Archive, restore or delete the project

Anyone in the community can create and change labels. Only Projects Admins and Projects Creators can delete them.

Create a project​

Only Projects Admins and Projects Creators can create projects.

  1. On the Projects page, select Create project.
  2. Enter a Project name. The Key fills in for you, and you can change it.
  3. Optionally pick an icon, add a description, and set a Start date and End date.
  4. Select Create project.

Project fields​

FieldRequiredNotes
Project nameYesUp to 200 characters.
KeyYesLetters and numbers, up to 10. Must be different from every other project in the community.
IconNoPick from the icon list.
DescriptionNoShows under the project name.
Start date, End dateNoLeave them empty to take the dates from the tasks.

Create a task​

  1. Open the project and select Add task.
  2. Enter a Task title, and optionally a description.
  3. Fill in any custom fields. Required fields always show. Select More fields to see the rest.
  4. Set the status, priority, Start date, Due date, Assign and Labels.
  5. Select Create task.

Turn on Create more to add several tasks in a row.

Task fields​

FieldNotes
Task titleRequired. Up to 512 characters.
DescriptionText with formatting and images.
StatusThe column the task is in.
PriorityNo priority, Low, Medium, High or Urgent. No priority by default.
AssigneePeople or roles.
Start date, Due dateOptional.
LabelsShared across the community.

Work on a task​

Select a task to open it. From the task page you can:

  • Change its Properties, such as status, priority, assignee, dates and labels.
  • Edit the description.
  • Add Sub-tasks, and tick them off as they are done.
  • Link it to other tasks in the same project under Linked tasks, as Related or Blocks.
  • Log time under Time tracking, if someone who manages the project has turned on Track time on tasks in the project settings.
  • Leave a comment and see the history under Activity.

You can also right-click a task in a list or on the board to change its priority, status, due date or assignee, copy its link, archive it or delete it.

Change many tasks at once​

  1. Hold Ctrl (⌘ on Mac) and select each task you want. Press Ctrl+A (⌘+A on Mac) to select them all.
  2. Use the bar that appears to Assign to, Set due date or move the tasks.
  3. Select Actions to change their status or priority, add a label, archive them or delete them.

Archive and delete​

  • Archive a task to clear it off the board without losing it. Archived tasks are under Archived in the Backlog. Move one back to the board from there.
  • Archive a project with Archive project in its menu. It disappears from the project list, the sidebar and the command palette. To bring it back, find it with search, open Project settings, then select Restore project on the General tab and confirm.
  • Delete a task (Delete... in its right-click menu) or a project (Delete project under Danger zone on the General tab) to remove it for good. This can't be undone. Only people who manage the project can delete.

Import and export tasks​

Right-click the project (or open its menu) and select Project settings, then go to Import & export.

  • Under Export Tasks, select JSON or CSV to download the project's tasks.
  • Import tasks adds tasks from a JSON or CSV file. It brings in each task's title, description, status, priority and dates. Labels, assignees and custom fields are not imported. A task with no priority comes in as Low.

Search and shortcuts​

Press / to search tasks, projects, comments and activity. Type at least 3 characters. A task number like WEB-12 finds that task.

Press Ctrl+K (⌘+K on Mac) to open the command palette and jump to any project.

KeysWhat it does
Ctrl+BShow or hide the sidebar
P then LGo to Projects
P then CCreate a project
T then CCreate a task (in Tasks)
V then B, V then LBoard or List
V then K, V then C, V then GBacklog, Calendar or Timeline

On a Mac, use ⌘ instead of Ctrl.

Notifications​

WhenWho gets it
A task is assigned to you or a role you are inYou
You are taken off a taskYou
A task moves to another columnIts assignees and creator
Someone comments on a taskIts assignees and creator
A task is due todayIts assignees and creator
A task is overdueIts assignees and creator

You don't usually get a notification for your own changes. Tasks that are archived or in a done column don't get due date reminders.

Limits​

ItemLimit
Project name200 characters
Project key10 letters and numbers
Task title512 characters
Column name100 characters
Custom field name100 characters
Label name80 characters