Projects
Create projects for bounded work with issues, milestones, and status updates.
Create projects for features or large units of work.
Overview
Projects are bounded deliverables with a planned outcome. They hold issues, optional documents, and milestones. A project can live on one or more teams, or be Personal. It may roll up to an initiative.
Status is the lifecycle (Idea, In Progress, Completed, …). Health is On Track, At Risk, or Off Track, from the latest status update. They are different fields.
The short summary is a title suffix. Put the spec in the project description or a document.
Create a project
- Press
NthenPto open the composer - Click Create new project on workspace Projects or a team's Projects list
- Open the command menu with
Cmd/CtrlKand choose Create new project… - To start from a template, choose Create new project from template…
The only required field is the project name. Default status is Idea. Assign a Lead, pick Teams (or Personal), and set Start and Target dates when you know them.
See Create projects.
Delete a project
Open the project … menu and choose Delete project. From a list, select one or more projects and delete them. Confirm the dialog — this cannot be undone.
Issues are not deleted with the project; they lose the project link.
View your projects
Workspace Projects (G then P) lists every project you can see. Each team's Projects link filters to that team.
Switch layout with Display options (Shift V). Projects support List, Board, and Timeline. Group or order by status, lead, target date, and other properties. Press F to filter.
Open a project for its overview, Issues, Activity, and Customers tabs.
Add issues to a project
Add existing issues or move them with Shift P. Create new issues from the project with C so the project is pre-filled. An issue belongs to at most one project.
You can also add a customer request from the project's Customers tab.
Attach issue views to projects
On the project's Issues tab, use Add new view to save a filtered perspective of that project's issues. Anyone who can open the project can use those tabs.
Attach project views to workspace projects page
Workspace Projects (/projects) has its own pill row. All projects is the default. Attached views lead that row.
Click Add new view to save the current filters, grouping, and display options as a view of this list. Pin a workspace view so everyone sees it here. Personal views still appear after the pinned ones.
This is separate from issue views attached to one project.
Project details sidebar
Click Show sidebar or Hide sidebar to toggle properties, milestones, progress, and resources. From here you can set lead, members, teams, dates, labels, and dependencies, and open the project graph.
Multi-team projects
Add more teams from Teams in the composer or the sidebar. A project must keep at least one team unless it is Personal. Personal projects do not use team estimates or some team-only properties.
Timeframes
Set Start date and Target date from the sidebar, the overview, or the list (Shift D sets the target date). Date pickers include Today, Tomorrow, End of this week, Next week, and Custom….
FAQ
Last updated on