Projects: create one and find your way
Create a project, get around its tabs and its Skills, add or remove its members, and see who can change it.
A project holds one piece of work: its board, its docs, its posts and its activity. Your projects are listed under Projects in the sidebar, and each one opens on its Overview.
See all your projects
The Projects page shows every project you're in as a card, grouped by team, with projects in no team last. To open it, click Projects in the dock, or press 2.
Each card shows:
- its board, small: how many cards are in To do, Doing and Done, with a green dot on each card an agent is working on now;
- the project's color and name, and how many questions in it wait for you;
- its lead and up to four of its people;
- the newest change on its cards: who did what to which card, and how long ago.
A green dot beside the name means an agent is working in the project now. Click a card to open the project. Click a team's name to open the team's page. Its header links the team's Docs and its channel.
Each group ends in New project in team, which starts a project in that team. Search finds projects by name or goal, and you can sort by Recent activity or Name. Your archived projects aren't shown; the page counts them at the end.
If you're in a team's channel, the page also says how many of the team's projects you aren't in. It never names them.
Create a project
In the sidebar, click + (Create project) next to Projects. Or press ⌘CtrlK and pick New project under Create.
Type a Project name. It is the only field you must fill in, and it can be up to 60 characters.
If you like, add an icon (Add an icon), a Description, a color, and Links to things that live elsewhere, such as a GitHub repo, a Drive folder or a Notion page.
Click Create, or press ⌘Ctrl↵. The project opens on its Overview.
You become the project's lead. Its board has the same four stages as every board; see The board: cards from To do to Done.
Get around a project
Every page of a project has one header and one bar under it. The header shows the project's mark, its name and its description. On the right it has the members, one button for the tab you're on, and … (More options) for everything else:
| Tab | The header's button |
|---|---|
| Overview | Invite |
| Board | New card, which opens Add card in To do |
| Posts | New post |
| Docs | New doc |
| Files | Upload |
When the header runs out of room, its buttons move into …. … also holds Copy path, Edit project and Archive project. On the Overview it holds Arrange widgets, and on the board Share board. On Chat, Search and Members sit on the right of the tab bar, and a closed room's Invite is the header's button. The room's own menu (notifications, pinned messages, shared files, Leave room) is in the project's …, and Copy path copies the room's transcript.
The bar under the header holds the project's places as tabs, then the tab's own view controls, such as grid or list, the board's Board, List and Map, or the posts' density. Click a tab, or press G and then its letter within about a second and a half.
| Tab | What it holds | Keys |
|---|---|---|
| Overview | A summary of the project, its latest activity, its newest posts, and Resources: its repositories and pull requests | GthenO |
| Board | The board, and its Map | GthenB |
| Posts | Posts, and a timeline of everything that happened | GthenP |
| Docs | The project's docs, as cards or a list, and New doc | GthenD |
| Files | The project's uploads, as a grid or a list, each with who uploaded it and where it's used, and Upload | GthenF |
| Chat | The project's newest room. Only there when the project has a room | GthenC |
The G keys work anywhere inside the project. 1 takes you back to the workspace's Home. On a phone, the tab row scrolls sideways.
Skills, the skills the project's agents can use, has no tab. Open it from the Skills card on the Overview, or press ⌘CtrlK and pick Project skills. On the Skills page no tab is shaded.
The Overview
The Overview is the project's front page. Under the header, from top to bottom, it shows:
- Work: how many cards are In progress, Up for grabs, in Triage and Done, with Open board to go to the board;
- whether the project is moving, waiting or quiet, and its goal if it has one;
- Briefing: a short summary of where things stand;
- Latest: the most recent events, with View all activity;
- Posts: the newest posts, with All posts.
Beside them, a column holds the project's Instructions, its Files and Skills: how many skills the project has, with Open to go to them.
The goal is set on the board: click Set a goal above the columns.
Edit, archive or leave a project
Open the project, click … (More options) at the top right, and pick Edit project to change its name, icon, color, description or links. Archive project takes it out of the sidebar; open the project again and pick Unarchive project to bring it back.
The same actions are in the sidebar and on the project's card on the Projects page: click its …, and pick Edit project… or Archive…. Archive asks you to confirm first. Leave project removes you from it. A project's last lead can't leave it.
Archiving keeps the project's board, docs and posts. To see your archived projects, click N archived projects at the end of the Projects page. Each one has Restore, which brings it back to the sidebar and the Projects page. Owners and admins also see the workspace's archived teams there, each with Restore.
Leads and members
A project has two roles: lead and member. Projects are private: only a project's members can open it. You are the lead of every project you create.
Within a project, any member can add and move cards and set the goal. Pinning a post takes a project lead, or a workspace owner or admin. In the app, Edit project and the project's own Archive project show only to workspace owners and admins. A project's leads can also archive it from its … in the sidebar or on the Projects page, and restore it from the archived projects.
See who's in a project
On the project's Overview, click the faces at the top right (Project members). The members dialog lists everyone in the project, leads first, with Lead beside each lead and the number of members above the list. Any member can open it.
Add people and agents
A project's leads, and the workspace's owners and admins, add people.
Open the members dialog from the faces on the project's Overview.
Click Add people or agents and type a name. The list holds everyone active in the workspace; people already in the project show Added.
Pick a person or an agent. They join as a member and see the project from then on.
Someone who isn't in the workspace yet has to join it first. Click Invite to workspace at the bottom of the dialog, invite them, and add them to the project once they've joined. An owner or admin can also add a person to any of the workspace's projects from Settings; see Add someone to projects.
Remove people, or leave
In the members dialog, a lead, owner or admin clicks Remove beside a person to take them out of the project. Any member can click Leave beside their own name; the project is then no longer yours to open, and sfora takes you to Home.
A project always keeps one lead. When a project has a single lead, the dialog says "The only lead. A project keeps one." under their name, and their Remove or Leave is off.
Availability
The Free plan holds 2 projects per workspace, and Basic holds 5. Business has no limit. Archived projects don't count.
Troubleshooting
You can't create another project
The workspace has reached its plan's project limit, and you see You've reached your project limit. Archive a project you no longer need, or upgrade the workspace's plan.
A project is missing from the sidebar
It is archived, or you aren't one of its members. An archived project still opens from its own link; pick Unarchive project in its … menu.
Someone can't see a project
Projects are private, and joining the workspace doesn't add anyone to one. A project lead, or a workspace owner or admin, adds them from the members dialog.
Remove or Leave is off
That person is the project's only lead, and a project keeps one.
There is no Edit project in the menu
Only workspace owners and admins see Edit project. They and the project's leads can archive it from its … in the sidebar or on the Projects page. Ask one of them.
Last updated on