Projects App
Plan your community's work in projects, with tasks on a list, board, calendar or timeline.
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:
| View | What it shows |
|---|---|
| Backlog | Tasks that are Planned but not on the board yet, and Archived tasks. |
| Tasks | Tasks on the board, as a List (the default) or a Board of columns. |
| Calendar | Tasks with a start or due date on a monthly calendar. Drag a task to change its date. |
| Timeline | Tasks 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:
| Setting | Who they are |
|---|---|
| Projects Admins | Full access to every project. |
| Projects Creators | Can 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.
- On the Projects page, select Create project.
- Enter a Project name. The Key fills in for you, and you can change it.
- Optionally pick an icon, add a description, and set a Start date and End date.
- Select Create project.
Project fields
| Field | Required | Notes |
|---|---|---|
| Project name | Yes | Up to 200 characters. |
| Key | Yes | Letters and numbers, up to 10. Must be different from every other project in the community. |
| Icon | No | Pick from the icon list. |
| Description | No | Shows under the project name. |
| Start date, End date | No | Leave them empty to take the dates from the tasks. |
Create a task
- Open the project and select Add task.
- Enter a Task title, and optionally a description.
- Fill in any custom fields. Required fields always show. Select More fields to see the rest.
- Set the status, priority, Start date, Due date, Assign and Labels.
- Select Create task.
Turn on Create more to add several tasks in a row.
Task fields
| Field | Notes |
|---|---|
| Task title | Required. Up to 512 characters. |
| Description | Text with formatting and images. |
| Status | The column the task is in. |
| Priority | No priority, Low, Medium, High or Urgent. No priority by default. |
| Assignee | People or roles. |
| Start date, Due date | Optional. |
| Labels | Shared 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
- Hold Ctrl (⌘ on Mac) and select each task you want. Press Ctrl+A (⌘+A on Mac) to select them all.
- Use the bar that appears to Assign to, Set due date or move the tasks.
- 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.
| Keys | What it does |
|---|---|
| Ctrl+B | Show or hide the sidebar |
| P then L | Go to Projects |
| P then C | Create a project |
| T then C | Create a task (in Tasks) |
| V then B, V then L | Board or List |
| V then K, V then C, V then G | Backlog, Calendar or Timeline |
On a Mac, use ⌘ instead of Ctrl.
Notifications
| When | Who gets it |
|---|---|
| A task is assigned to you or a role you are in | You |
| You are taken off a task | You |
| A task moves to another column | Its assignees and creator |
| Someone comments on a task | Its assignees and creator |
| A task is due today | Its assignees and creator |
| A task is overdue | Its 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
| Item | Limit |
|---|---|
| Project name | 200 characters |
| Project key | 10 letters and numbers |
| Task title | 512 characters |
| Column name | 100 characters |
| Custom field name | 100 characters |
| Label name | 80 characters |