The workspace

The dock: every button and its key

Every button in the dock and its key, the places it holds, a project's tabs, the keys that moved, and how the dock works on a phone.

The dock is the column of buttons along the left edge of the window, on every page, whether the sidebar is open or closed. It holds the same buttons wherever you are: in the workspace, a team or a project. Most buttons have a key too, so you can get around without the mouse. On a phone, the dock is a row along the bottom instead (see below).

What's always in the dock

ButtonWhat it doesKey
ContentsOpens or closes the sidebar⌘\
NewOpens a short menu: a doc, a post, a project, a chat or a direct messageN
SearchOpens the command palette/
HomeGoes to Home, your inbox1
ProjectsGoes to the projects page2
TasksGoes to Tasks3
DocsGoes to Docs4
ChatGoes to the Chats page: every room and direct message you're in5
Your workspaceA square with the workspace's initial, just above Settings. Opens the workspace's menu: Settings, Members and invite, Billing (owners and admins), Agents, another workspace to switch to, Create a workspace and Join with an invite code
SettingsGoes to Settings, at the foot of the dock7

Point at a button to see its name and its key. The dock's buttons sit straight on the window's background. The button for the place you're on is shaded, and so is Contents while the sidebar is open. A number on Home counts the questions waiting for you, and a blue dot means unread mentions. A dot on Search means there's something new in What's new, which you find in the palette.

Which button is shaded

The button for the page you're on is shaded:

ButtonShaded on
HomeYour inbox
ProjectsThe projects page, any page of a project (its rooms too), and a team's page
TasksTasks
DocsThe workspace's docs, a team's docs, the Files page, and a doc that isn't a project's
ChatThe Chats page, direct messages, and every room that isn't a project's
SettingsSettings

Chat opens the Chats page: every room and direct message you're in, newest first. With none, it says No chats yet and points you to New chat and Browse all rooms. A blue dot on Chat means a room is unread. Home keeps its number.

The sidebar lists what's in the place you're on: the docs on Docs, the rooms on Chat. Going to a place only takes you there. It never opens or closes the sidebar; Contents does that.

A project's tabs

A project's own places are tabs in its header, not in the dock: Overview, Board, Posts, Docs, Files and, when the project has a room, Chat. Docs holds the project's docs. Files holds its uploads. Its repositories and pull requests are under Resources on its Overview. Chat opens the project's newest room, and the tab row stays above it.

Click another project in the sidebar and it opens on the same tab: from Board, its Board. A tab that project doesn't have opens its Overview.

Inside a project, press G and then a letter to open a tab. Press the letter within about a second and a half.

KeysTab
GthenOOverview
GthenBBoard
GthenPPosts
GthenDDocs
GthenFFiles
GthenCChat

A project's Skills has no tab. Open it from the Skills card on the project's Overview, which shows how many it has, or from the palette: pick Project skills. On the Skills page no tab is shaded, and the path bar says Skills.

Inside a project, New starts a post or a chat in that project.

Keys without a button

KeyWhat it does
9Goes to the workspace map
?Shows every key

Everything, the map and Skills are in the command palette, with Files and Settings. While you're on Skills, the sidebar lists the skills of each project.

Go up a level

Press ⌘↑ to go up one level. In a project, it goes from the Board, Posts, Docs or Files tab to the project's Overview, and from the overview to Home. Anywhere else in the workspace, it goes to Home.

Flip through cards

With a card open on a project's board, [ and ] open the previous and next card in its column. Outside a project, the dock leaves these keys to the page.

See every key

Press ? to open Keyboard shortcuts. It lists the dock's keys, a project's tabs under In this project, the keys that moved under Moved in this release, and the palette's G keys under In the open palette. Press Esc or ? to close it. The full list is in Keyboard shortcuts, by where they work.

The dock's keys don't fire while you're typing in a field or an editor, or while a dialog is open.

Troubleshooting

A number key does nothing

The keyboard is in a text field or an editor, or a dialog is open. Press Esc, or click an empty part of the page, and try again.

6 or 8 does something else

Two keys moved in this release:

  • 8 still opens Chat, until the next release. Chat is 5 now.
  • 6 does nothing now. The workspace's files are Files in the Docs list, 4, and a project's are on its Files tab.

On a team's page, 4 opens the workspace's Docs now. The team's docs are Docs on its page, or its row in the Docs list.

Inside a project, 2 to 5 changed too: they open the dock's places now, the same as everywhere, and the project's own places are its tabs, G and a letter.

The first time you press a key whose meaning changed, a short note says where its old place went. It shows once for each key.

Where did Skills go?

It left the dock. Open it from the command palette: press / and type its name. On Skills, the sidebar lists All skills and each project's. A project's Skills is also on its Overview, in the Skills card.

The inbox shows only some of my mentions

The palette shows your six newest unread mentions. When you have more, the last row of the Inbox group reads "View all 9 mentions", with your own count. Pick it to see every one.

Last updated on