Цю сторінку ще не перекладено.

Invite people and choose their roles

This page is for the owners and admins of an organization. You will invite people, choose what each of them may do, and change or remove their roles later. It also explains the roles, so anyone can see what theirs allows.

The roles

Each person has two kinds of role: one in the organization, and one in each workspace and on each instruction. The organization's role says who runs the team. The workspace role says what someone may do to its instructions.

Roles in the organization

Role What they can do Takes a seat
Owner Everything an admin can. Only an owner makes or removes another owner, and only an owner deletes the organization. Yes
Admin Runs the organization: its people, its workspaces, its plan, its rules and its tools. Manages every workspace and every instruction in it. Yes
Billing Pays for the organization: opens the plan's payment pages. On instructions, works like a member. Yes
Member Works on instructions with the role they have in each workspace. Reads every instruction shared with Your organization. Yes
Guest Sees only what is shared with them, one instruction at a time. Can't be given a role in a workspace. No

Agents can be members too. An agent is never an owner, an admin or a guest, and it never takes a seat. See Agents in your organization.

Roles in a workspace, and on an instruction

Role What they can do
Reader Reads the instruction, its suggestions, its comments and its history.
Contributor Proposes changes and comments. What they type becomes a suggestion that a maintainer accepts.
Maintainer Edits, accepts or rejects changes, restores earlier text, publishes versions and makes one live.
Admin Everything a maintainer can, and also shares the instruction, decides who has access, renames, archives and deletes it, and sets the rules on its version names, such as stable taking signed versions only.

The same four roles are used when you share one instruction with someone. See Share an instruction. An agent is at most a Maintainer.

In Settings ▸ People, each person shows one role that sums up both. A member shows their role in the default workspace, such as Contributor. Owners, admins, billing and guests show their organization role. You may also see:

  • No access: a member with no role in the default workspace.
  • Admin of its instructions: a member who administers the default workspace's instructions without running the organization.
  • Guest with a role on its instructions: a guest who was given a workspace role some other way. It isn't offered as a choice.
Settings ▸ People.

Before you start

  • Who can do this: the organization's owners and admins.
  • Where: Settings ▸ People, in an organization you made with New organization. Your personal organization is yours alone and has no invitations. See Organizations and workspaces.
  • Seats: everyone except guests takes a seat. Your plan sets how many:

Plans Community 3 · Pro 1 · Team 10 · Enterprise unlimited

Invite someone

  1. Open Settings ▸ People

    The top shows the organization, your role in it, and three counts: people, seats and agents. Choose Invite people at the top of the page, or go to the Invite people row.

  2. Write their email in Invite by email

    Use the address they sign in with. Only someone signed in with that address can accept.

  3. Choose their role in Their role

    Choose Reader, Contributor, Maintainer, Admin or Guest. Contributor is chosen to start with. Reader, Contributor and Maintainer make them a member with that role in the default workspace. Admin makes them an admin of the organization, and Guest a guest. To give them a role in another workspace, add them there after they join. Nobody is invited as an owner: once they join, an owner can make them one.

  4. Choose Invite

    The invitation's link appears once, with the date it works until. Choose the copy button, send the link to them yourself, for example by email or chat, then choose Done. instruction.md doesn't send it for you.

The link works once, for 14 days. If you lose it, invite the same address again: the new invitation replaces the old one.

See and revoke invitations

Invitations that haven't been accepted are listed under Invitations, with the role and when each was sent. Choose Revoke to cancel one. Its link stops working at once.

Accept an invitation

This part is for the person who was invited.

  1. Open the link you were sent

    The editor opens Join an organization. If you aren't signed in, sign in first.

  2. Check what it says

    It says Join the organization as a role, for example "Join Acme as a contributor".

  3. Choose Accept, or Decline

    After Accept, the editor opens in that organization, at its People page. A guest goes to Shared with me instead.

    Decline takes you to the editor without joining. Nobody is told, and the link still works until it expires.

What the invited person sees.

If you are signed in with another address, the page says so and shows Use another account. Choose it and sign in with the address the invitation was sent to. If you opened the editor without the link, paste the whole link into The invitation link and choose Accept.

Change a role

  1. Open Settings ▸ People

    Each person's role is a list next to their name.

  2. Choose the new role

    It changes at once, and a message says "… is now …". If the server refuses, the list goes back to the role they have.

Some rules apply:

  • Only an owner can make someone an owner, or change an owner's role.
  • Nobody changes their own role. To step back, an owner makes someone else an owner first, then leaves or asks that owner to change their role.
  • Making a guest anything else takes a seat.

To give someone a role in a workspace other than the default one, use Settings ▸ Workspaces. See Create, rename, restrict and delete a workspace.

Remove someone, or leave

  • Remove someone: choose Remove next to their name, then Remove again. They lose access to the organization's instructions. Their changes and comments stay. Only an owner removes an owner.
  • Leave: choose Leave… next to your own name, then Leave. You lose your role in it. What is shared with you on single instructions stays, and the owners and admins can invite you again. The editor then opens your own organization.

Hand over ownership

An organization always has at least one owner. If you are its only owner, there is no Leave… for you. To hand it over:

  1. Make someone else an owner

    Choose Owner in their role list.

  2. Leave, or step back

    Now you can choose Leave…. Or the new owner can change your role to the one you want.

Agents in your organization

An agent that has its own sign-in joins the organization as a member. It shows in Settings ▸ People with an Agent badge, and it doesn't take a seat. Its role is Reader, Contributor or Maintainer.

Agents' own sign-ins are made under Developer ▸ API keys. That page shows in the side bar when developer mode is on. How many agents your plan allows:

Plans Pro 10 · Team 100 · Enterprise unlimited

When you remove an agent, it stops reading the organization's instructions, but its sign-in still works until someone revokes it. To bring it back, use Add an agent back in Settings ▸ People.

The role new members get

When an invitation doesn't name a role on the instructions, a new member gets the organization's default. The invitations you send from Settings ▸ People always name one. Others, such as the ones your company's directory sends, may not.

Set the default in Settings ▸ Security ▸ What new members can do: Read, Suggest or Publish. See Set your organization's rules.

Check it worked

  • The new person shows in Settings ▸ People with the role you chose.
  • Their invitation is gone from Invitations.
  • The seats count went up by one, unless they are a guest.

If it doesn't work

You see Why What to do
Write their email first The email field is empty or isn't an address. Write their full email.
someone with that email is already a member They are in the organization already. Change their role instead.
this plan has … seat(s) and all are taken; free one or upgrade Every seat is in use. Remove someone, make someone a guest, or upgrade in Settings ▸ Billing. See Plans, limits and billing.
This invitation can't be used: it was used already, withdrawn, or it expired. The link was accepted, revoked, or is older than 14 days. Ask an owner or an admin for a new invitation.
this invitation is for another address; sign in with the address it was sent to You are signed in with another email. Choose Use another account.
verify your address to accept this invitation Your sign-in hasn't confirmed your email address. Sign in through your company's sign-in, or ask the organization's admin.
the last owner can't step down; make someone else an owner first You are the only owner. Make someone else an owner first.
Still stuck Write to us at support.

Questions

What can a Reader, a Contributor, a Maintainer and an Admin do?

A Reader reads. A Contributor proposes changes and comments. A Maintainer edits, accepts changes and publishes versions. An Admin also shares the instruction, decides who has access, and renames, archives or deletes it. See the roles.

In Settings ▸ People, write their email, choose their role and choose Invite. Send them the link it shows. The link works once, for 14 days.

Do guests count as paid seats?

No. Guests take no seat and are never billed. Everyone else does, including billing admins. Agents don't take seats either.

Can I invite someone straight into a workspace other than General?

Not from Settings ▸ People. The role you choose there is for the default workspace. Once they join, give them a role in another workspace in Settings ▸ Workspaces.

Why can't I leave my organization?

You are its only owner. Make someone else an owner first, then choose Leave…. Or delete the organization, if nobody needs it.

For developers: the full permission matrix, with the names the tools use, is on Organization policy.

Last checked against the product:

Was this page helpful? Report a problem