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
| Right | Value | Allows |
|---|---|---|
READ | 0x01 | View the content. Every other right includes it. |
SHARE | 0x02 | Share it with others, up to your own rights. |
COPY | 0x04 | Make a copy. |
CONTRIBUTE | 0x08 | Add to it — for example, a note or a file — without changing what is already there. |
EDIT | 0x10 | Change its values. |
DELETE | 0x20 | Delete 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:
| Step | Rights included | Value |
|---|---|---|
| Read | READ | 0x01 |
| Share | READ, SHARE | 0x03 |
| Copy | READ, SHARE, COPY | 0x07 |
| Contribute | READ, COPY, CONTRIBUTE | 0x0D |
| Edit | READ, SHARE, COPY, CONTRIBUTE, EDIT | 0x1F |
| Delete | all six | 0x3F |
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 level | What the person can do | Rights |
|---|---|---|
| View only | View | READ |
| Viewer | View, copy and reshare | READ, SHARE, COPY |
| Contributor | View and add to it, but not edit or reshare | READ, COPY, CONTRIBUTE |
| Editor | View, add and edit | READ, 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
| Audience | Who gets access |
|---|---|
USER | One 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_MEMBERS | Everyone in a group. This gives View only, whatever level is chosen. |
GROUP | The 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_MEMBER | One person in their capacity as a member of a particular group. |
AGENT | An OnEarly Agent. |
SYSTEM | OnEarly itself. |
PUBLIC | Everyone, 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
CONTAINSlinks 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.
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.
Share links
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.