A workspace holds projects, the people who review them and the agents that publish to them. Everything you see in the sidebar, including the Inbox, All documents and Projects, belongs to the workspace you're in.
Personal workspaces, teams and team workspaces
Your personal workspaces are yours alone. The first one is named after you, always uses the slate colour, and can't be renamed, left or deleted; its name follows the name in your profile. You can create as many more personal workspaces as you like, for side projects or to keep things apart. They share your personal plan.
A team is the people you work with and the plan that pays for them. Each team has one or more team workspaces, each with its own members and projects. Someone can be an admin in Marketing and a viewer in Engineering. Everyone in any of a team's workspaces is on the team and uses one of its seats.
A team workspace is either:
- Private: only the people added to it can see it. New workspaces are private.
- Open: everyone on the team can find it under Browse workspaces and join it as a member.
The team's owner, billing admins and admins can open any of its workspaces, even ones they aren't in; each such visit is recorded in the team's audit log.
The rail
The narrow column on the far left is the rail. It shows a tile for each workspace you belong to: your personal workspaces first, then each team's, with a thin line between groups. Hover a tile to see its name and team. Click a tile to switch; planpage keeps you on the same kind of page, so switching from one Inbox takes you to the other workspace's Inbox. Opening a document from another workspace, from a link or a notification, switches you to that workspace too. A number on a tile counts unread items waiting in that workspace.
Below the tiles:
- New workspace (the + tile) creates a workspace; see Create a workspace.
- Browse workspaces (the compass) appears when your teams have open workspaces you haven't joined.
- Your account (your picture) opens your account settings: Profile, Logins, Agent connections, Notifications, Your data, Security log, Shared with you and Help. These follow you into every workspace, and workspace admins can't see them.
You can also switch from the workspace name at the top of the sidebar. Its list is grouped the same way, shows your role and how many items wait in each workspace, and ends with New workspace, Browse workspaces and New team.
Right-click a tile, or long-press it on a phone or tablet, for that workspace's menu: Switch to it, Mark all as read (when it has unread items), Open settings, Invite people (team workspaces), Change colour and the icon (owners and admins), and Leave, which asks first. These work on any workspace you belong to, without switching to it first. The current workspace's menu is also behind the ⋯ beside its name at the top of the sidebar.
Colours
Each workspace other than your first personal one has a colour: Clay, Moss, Sea, Plum, Ochre or Slate. Everyone in the workspace sees the same colour on its tile. It's there to tell workspaces apart and never means a status. Owners and admins change it in Workspace settings → General, or with Change colour in the workspace's menu. A workspace can also show a picture instead; see Icon in the same place.
Create a workspace
- Click the + tile in the rail, or New workspace in the switcher.
- Pick where it goes: Just for you (a personal workspace) or one of your teams.
- Give it a name.
- For a team workspace, pick who can see it (private or open) and tick anyone from the team to add, with the role they get.
- Click Create workspace. You're its owner, and planpage switches to it.
In a team, the owner, billing admins and admins can create workspaces. The team can let every member create them too, in Team settings → General. A team that has run out of plan can't get new workspaces until it's renewed, and a team can have up to 100 workspaces (archived ones count; staff can raise this).
Your existing agent connections don't reach a new team workspace until you add it to them in Your account → Agent connections.
Join an open workspace
Browse workspaces, in the rail or the switcher, lists the open workspaces of your teams that you aren't in yet, grouped by team, with how many members and projects each has. Join adds you as a member and switches to it. Private workspaces don't appear; an admin has to add you.
Start a team
New team, in the switcher, creates a team with its first workspace, which has the same name to begin with. You're its owner, and planpage takes you to Team settings → People to invite people. When billing is turned on, teams need a paid plan: your first team starts with a free 14-day trial of the Team plan for up to 10 people, with no card needed. If you've already had a trial, you pick a plan straight after creating the team, and its workspaces are read-only until you do.
Workspace settings
Workspace settings in the sidebar has these tabs:
- General. Name, colour and, for team workspaces, who can see it (owners and admins of the workspace, and the team's admins). The icon, moving the workspace, and leaving, archiving or deleting it.
- Members and agents. People, invitations and the agents with access. See Members and roles.
- Projects. Every project in the workspace, with its repository and document count, archiving and deleting, and the Trash.
- Billing and Integrations. In personal workspaces only: your personal plan and usage (when billing is turned on), the GitHub app and your custom domain. A team's are in Team settings.
Team settings
Team settings in the sidebar is for the team's owner, billing admins and admins. Its tabs are:
- General. The team's name and slug (separate from its workspaces' names), whether members can create workspaces, and, for the owner, deleting the team.
- People. Everyone on the team, their team role, seats and which workspaces each person is in. See Members and roles.
- Workspaces. Every workspace in the team, including private ones and archived ones, with members, projects and owner. Open one, manage its members, archive or restore it, delete an empty one, or create a new one.
- Billing. The team's plan; owners and billing admins only. See Plans and billing.
- Integrations. The GitHub app and the custom domain for shared pages, for all the team's workspaces. See GitHub and Sharing.
Plans and billing
When billing is turned on, a team's plan covers all of its workspaces: seats, image storage, daily limits, custom domains and exports are counted across the team. Your personal workspace uses your personal plan.
A team's plan is in Team settings → Billing, which only the team's owner and billing admins see. Your personal plan is in Workspace settings → Billing in your personal workspace. Either way you upgrade there, and manage a paid plan without leaving planpage: change seats or storage packs, switch between monthly and yearly billing, cancel or resume, add or remove cards, and download invoices and receipts. Payments are handled by Polar, our merchant of record; its billing portal is linked at the bottom for billing address and tax ID changes.
When a plan ends
If a team's plan ends (it's cancelled, a payment fails for good, or a trial runs out):
- For 14 days nothing changes. The owner and billing admins get an email when it ends and again a few days before the next step, and see a banner asking them to renew.
- Then its workspaces become read-only. Everyone can still read every document and the owner and admins can export, but nobody can write, comment or approve. Everyone in the team sees a banner; the owner and billing admins can renew from it.
- 90 days after the plan ended, the team is archived. Its documents, with their versions, comments, reviews, steps and share links, are stored away from the live service and taken out of its workspaces. Nothing is deleted. The owner and billing admins get an email, and everyone in the team sees a banner saying the team is archived.
While a team is archived, its owner, billing admins and admins can download a copy of each workspace without paying: click Download a copy in the banner, or go to /team/archive. Each download is a zip with every document as markdown and an export.json holding everything else. Opening one of the team's documents says the team is archived, and its public links stop working until it's back.
Renewing at any point puts everything back as it was. After an archive, it takes a few minutes: the banner shows how many documents are back so far, each document reappears in its place with its history and share links, and the owner and billing admins get an email when it's done. A personal plan that ends works the same way for the first 14 days, then your personal workspace moves to the Free plan's limits; nothing becomes read-only.
Move a workspace into a team
A workspace can change hands, with its projects, documents, versions, comments and links. In Workspace settings → General → Move to a team:
- A personal workspace can move into any team where you can create workspaces. You stay its owner, it starts out private, and from then on the team pays for it and its owner and admins can open it. Your agent connections that reach your personal workspaces get the same access to it in the team. Moving your first personal workspace moves its projects into a new team workspace instead, and the personal one stays, empty.
- A team workspace can move to another team, if you own both. Its members come along: anyone who isn't on the new team joins it and uses one of its seats, so the move is refused if there aren't enough free seats. People who were on the old team only for this workspace leave it, which frees their seats there.
Images already uploaded stay in the library they were uploaded to and keep working in the documents. Pending invitations and invite links for the workspace are cancelled, because they'd add people to the old team.
Leave, archive or delete a workspace
In Workspace settings → General:
- Leave workspace is available in team workspaces to everyone except the workspace's owner. Leave in the workspace's menu does the same. You lose access to its projects and documents at once, and your agent connections stop reaching it. If it was your last workspace in the team, you leave the team too, which frees your seat. An admin has to add you again to come back.
- Transfer ownership is how a team's owner steps back. In Members and agents, choose Transfer ownership… next to another member. See Members and roles.
- Archive makes a team workspace read-only and hides it from its members' rail, lists, search and inbox; agents stop reaching it. Nothing is deleted. The team's owner and admins can still open it, and restore it from Team settings → Workspaces. The workspace's owner and the team's admins can archive it. A team's first workspace can't be archived.
- Delete workspace removes a workspace once it has no projects left (move or delete them first; projects in the Trash are deleted with it). You confirm by typing its name. A team's first workspace and your first personal workspace can't be deleted.
To delete a whole team with all its workspaces, its owner uses Team settings → General → Delete team, after cancelling the team's plan. You confirm by typing the team's slug, and it can't be undone.