Skip to main content

Permissions & Roles

Nobody can see your content until you share it. A share names who gets access, what they can do, and, if you choose, when access ends. You can see and remove every share you have made.

Group roles are separate from content sharing. They control what a person can do in a group, not which content they can see. See Group roles.

The six rights​

RightValueAllows
READ0x01View the content. Every other right includes it.
SHARE0x02Share it with others, up to your own rights.
COPY0x04Make a copy.
CONTRIBUTE0x08Add to it — for example, a note or a file — without changing what is already there.
EDIT0x10Change its values.
DELETE0x20Delete it.

The author of a piece of content holds all six (0x3F).

Rights are granted as steps on a ladder. Each step includes the steps below it, except that Contribute leaves out Share:

StepRights includedValue
ReadREAD0x01
ShareREAD, SHARE0x03
CopyREAD, SHARE, COPY0x07
ContributeREAD, COPY, CONTRIBUTE0x0D
EditREAD, SHARE, COPY, CONTRIBUTE, EDIT0x1F
Deleteall six0x3F

When a set of rights is saved, it is stored as the highest step it names.

Access levels in the app​

When you share in the app you choose one of four access levels: View only, Viewer, Contributor or Editor. View only and Viewer are different levels: a Viewer can also copy and reshare.

Access levelWhat the person can doRights
View onlyViewREAD
ViewerView, copy and reshareREAD, SHARE, COPY
ContributorView and add to it, but not edit or reshareREAD, COPY, CONTRIBUTE
EditorView, add and editREAD, SHARE, COPY, CONTRIBUTE, EDIT

Under Account → Permissions, the same four levels are named by what they allow: View only, View and reshare, Contribute and Edit.

Deleting is never shared through an access level. It stays with the owner.

Who you can share with​

AudienceWho gets access
USEROne person. You can search for them or enter an email address. If they don't have an account yet, they are invited when you share.
GROUP_MEMBERSEveryone in a group. This gives View only, whatever level is chosen.
GROUPThe group itself. Reached only by members whose role holds manage-group or an act-as-group permission (see Group permissions), not by every member.
GROUP_MEMBEROne person in their capacity as a member of a particular group.
AGENTAn OnEarly Agent.
SYSTEMOnEarly itself.
PUBLICEveryone, including people who are not signed in. Public access is capped: it can never include Edit or Delete. The share dialog does not offer public sharing. Existing public shares can still be seen and removed.

When you share content with someone, they are notified, subject to their notification settings. To keep content private, notifications about shares do not include the content's title.

What a share covers​

Sharing something also shares what is inside it.

  • A share reaches everything under the shared content through CONTAINS links that have carbon copy turned on. The app tells you this when you share.
  • On the content inside, the person gets the same rights except Edit. An Editor of a folder, for example, can add to and share what is inside it, but cannot change values someone else wrote there.
  • A link with carbon copy turned off stops the share. Content below it stays private unless it is shared directly.
  • A reference with carbon copy turned on lets whoever can see the content view the referenced item too. Setting up such a reference needs Copy on the referenced item.
What a Share Covers
What a Share Covers

Membership of a group never gives access to content by itself. Content is visible to a group only when it is shared with the group.

Ending access​

  • Expiry. A share can last until a date you choose. Access ends at the end of that day (UTC). Only the owner can extend an expiry or remove it.
  • Removing access. Open Share → Who has access on the content, or go to Account → Permissions to see everyone who can see your things, grouped by person, and remove access item by item.
  • Narrowing. Choosing a lower access level removes the rights that are no longer included.

Expired shares stay listed so you can see who used to have access.

Invitations with a passcode​

When you share with someone by email or mobile number, you can require a passcode before they can open the content. The passcode can be their date of birth, their full name, or another answer you choose. The person accepts the share before it takes effect.

A share link gives access to anyone who opens it.

  • Choose the access level for the link.
  • Optionally require a PIN, and set an expiry date.
  • People can open a link without signing in, and can sign in to keep the content in their profile.
  • Whatever someone adds through a link belongs to them.

Editing through a share​

When someone edits content through a share, the change is saved as a new version under their name. The original author keeps their access, and the earlier version stays in the history.

Using content types​

To create content of a given type you need at least View only on that type. OnEarly's built-in content types can be viewed by everyone, so anyone can use them.