openJIIDocs
Experiments

Collaborators & access levels

Add people or organizations to your experiment, choose between Can view and Can edit, and handle requests to join.

Experiments are meant to be shared. Everyone you share an experiment with directly appears in one list, and each row carries one setting: how much they can do.

The list is that set of direct shares — users, teams and organizations someone added on purpose. It is not a full audit of who can open the experiment: members of the organization that owns it reach it through their organization role, and a public experiment is readable by anyone.

Those people are not simply missing. Owners of the owning organization are named individually; its admins and members appear as counted summary rows; anyone who also holds a share is broken out into their own row and subtracted from those counts; and public readers get no row at all. A row may also carry a Redundant grant badge, meaning the share adds nothing to access the person already has.

Who can access your work? explains the whole model in one page — the three routes in, why the strongest wins, and how to read a row. Start there if someone has access you cannot account for.

The two access levels

  • Can view — open the experiment, read its data and visualizations, and contribute: take measurements with the mobile app, and add annotations and comments. This is usually the person in the field.
  • Can edit — everything above, plus the experiment's settings, publishing, archiving, and managing who else has access.

What each level can do

ActionCan viewCan edit
See the experiment, its data and visualizations
Take measurements with the mobile app
Add annotations, comments and flags
Upload measurement data on the web
Add or edit experiment metadata
Edit experiment settings (name, description, visibility)
Create and edit visualizations
Attach or change the workbook, and edit locations
Add or remove collaborators and change their level
Archive the experiment

Being added is what lets someone contribute. Making an experiment public lets anyone read it — it never lets a stranger add measurements or annotations. Only people who hold an access level on the experiment can contribute, which is why the lowest level is still called "Can view" rather than "read-only".

The Collaborators tab with access levels and the Invite button

Invite a collaborator

Open your experiment and go to the Collaborators tab, then select Invite. One search field covers every way of adding someone:

  • A user — search by name or email and select them. They get access immediately at the level you choose.
  • An organization — switch Share with to Organization and pick one of your own. Everyone in that organization gets the level you choose.
  • Someone by email — type an email address that is not yet on openJII and choose Send invite by email. They receive an email, and they join the experiment at the chosen level once they create an account.

Choose the access level in the same dialog. New collaborators default to Can view, which is the level that lets them contribute.

The Collaborators tab groups people into three sub-tabs:

  • Collaborators — the users and organizations the experiment is shared with directly, each with their level.
  • Invited — pending email invitations, each showing the level it will confer. Revoke one before it is accepted and re-invite if you need to change that level.
  • Requests — pending requests to join (see below).

The filter above the tabs narrows all three lists at once.

Requests to join a public experiment

Anyone viewing a public experiment they are not part of can select Request to join, with an optional message. People who can manage the experiment see these under the Requests sub-tab and can Approve or Reject them. Approved people join with Can view, so they can start contributing.

Changing a level, removing someone, leaving

From the Collaborators sub-tab, change anyone's level with the dropdown on their row, or remove them with the bin button next to it. Your own row is marked (you) and its button is Leave, which gives up your own access.

Some rows carry an Outside Collaborator label. That is information, not a restriction: it marks a person or organization from outside the organization that owns the experiment, so you can see at a glance who is external. What they can do still comes from their access level.

What has to hold is that the experiment stays administrable — not that it keeps a Can edit collaborator. While the organization that owns it still has an owner, that owner is in full control, so you can remove or lower anyone here, including the last Can edit. The refusal appears only once that organization has no owner left and this row is the last person who could still administer the experiment — a shared organization does not count. The reason is shown when it does.

Removing someone takes away this access. They may still be able to reach the experiment another way — through the organization that owns it, through an organization or team they belong to that was also given access, or because the experiment is public. The confirmation dialog says so; check those routes too if the intent is to remove access entirely.

Who can see the list

The collaborator list, the pending invitations and the access levels are only visible to people who can manage access — that is, holders of Can edit and admins of the owning organization. Everyone else sees the experiment's contributor credit (names and avatars) and nothing about who holds which level.

If you hold Can view, the Collaborators tab shows you a Your access card instead of the list, with a Leave button for giving up your own access.

For access to macros, protocols, workbooks and devices, see Sharing & Collaboration — those resources use the same two levels on their own Collaborators tab, except that a device is never publishable.

On this page