Share something and choose who can open it

One way to share in every module: who a board, project, notebook or design is open to, the five levels, and the Share dialog.

In short

In an organization, two things decide what you can do with a board, project, notebook or any other thing. Your role is the ceiling. The thing decides who it is open to and who it is shared with. You hold the lower of the two. The Share dialog is the same in every module.

Before you start

Steps

  1. Open the thing and press "Share" in its header, or press its "Visible to" line. Only people who manage the thing can change who it is shared with.
  2. Under "Add a person, team or role", type a name, a team or a role. A team can be "This team only" or "With the teams below it".
  3. Choose the level. You are never offered more than you hold yourself.
  4. For a share that should end, set "Access until". Leave it empty for no end.
  5. Press "Add". The share is saved at once - there is no Save button.
  1. When a link opens a thing that is not open to you, the page says it is not open to you.
  2. Choose the level you would like, and add a line for whoever answers if you like.
  3. Press "Ask for access". Its managers get one item in their inbox, and you are told when someone answers.

Result: every share is a row in the list with its level, who added it and when, and its end date. Change the level from the row, or remove the share.

How sharing and access work

Everything inside a thing has the thing's access: the cards of a board, the requests and runs of a project, the notes of a notebook. Nothing inside is narrower. To keep something apart, put it in a thing of its own - a second notebook, a second project. No role opens everything. A private thing is open only to the people, teams and roles it names. That includes administrators, until they open it with Manage all, which the thing records for good.

What each level lets you do

Each module's Share dialog says in one line what each level means there, such as "Edit - changes requests and suites, and can use this project's secrets".

Edit in a tester is trust with its secrets Whoever can change a request, a case or a track can make it send a project's secret somewhere else. Give Run to people who should only run what is saved.

Who can open it

At the top of the Share dialog, "Who can open it" sets the thing's audience inside the organization:

The three choices that name a team need the thing filed under a team first; until then the dialog says "File it under a team first". A choice that opens the thing to a team opens it to work on, never to manage: managing is given to a person, by name.

The Visible to line and the Private mark

Under every shared thing's title, one line says who can open it and what you can do there, for example "Visible to the Payments team - you can edit". Managers press the line to open Share. In lists, a private thing carries a small Private mark. A thing that is not open to you is not listed at all - not even its name.

How a new thing starts

The create dialog says who the new thing will be open to before you make it - for example "Starts visible to the Payments team". Whoever makes a thing manages it. The start comes from these, and the first match wins. First is your choice in the create dialog. Next are the defaults of the team it is filed under. Then comes the organization's Settings › General › How new things start. Last is the product's start below.

A thing in your Personal Workspace is yours alone. Some modules share a personal thing with people by email address - an API Tester project or folder, a notebook, a calendar - never with a team or a role.

Good to know

Share with someone who has not joined yet

If you may invite people into the organization, type an email address in the add field and choose "Invite and share". They are invited with the organization's default role, and the share waits for them until they join through that invitation. The list shows it as "Someone invited to the organization", with the level - never who it is for. A waiting share ends by itself when the invitation is declined, withdrawn or runs out; "End this waiting share" takes it off by hand. A board also offers "Invite as a guest" - see /help/boards/board-guests.

When nobody manages it

If the only person who managed a thing leaves, loses the role or is paused, the thing is released: nobody manages it, and its shares stay as they were. Its people see "Nobody manages this board" (or project, notebook and so on) under the title. A person who holds Manage all sees two ways out. Each asks for a reason that stays on the thing for good. "Give a manager" names a member whose role can manage it. "Open with Manage all" gives them Manage on it, and its people are told.

A hand-over never passes managing When someone leaves, work done in their name - a schedule, a monitor, an assigned card - can pass to the person who takes over. Managing a thing never passes that way: it is shared at Manage before they go, or given with Manage all afterwards.

Make it private, and what happens when access narrows

A manager can always make a thing private, even on a plan that is read-only. A thing can narrow in several ways: a preset made private, a share removed or lowered, a team left, a role changed, or a member paused. When it narrows, it leaves the lists, search, Home and inbox of everyone who lost it at once. A page they have open stops updating.

Ways in from outside - a published page, a mock server, a public card link, a form - are not closed by a preset. Each has its own switch. The Share dialog lists them, with "Close" beside each, and the organization's Access › Outside access lists them all.

If something goes wrong

Related