Common Ink
All docs

Workspaces and sharing

A note is private unless it is in a shared folder. Each member has a Private that only they see, and the workspace has shared folders, each seen by everyone or by the people it names. This page covers your Private, shared folders, roles, invites, sharing one note with a person or a link, leaving, and signing out.

Workspaces

The first time you sign in with Google, Common Ink makes a workspace for you. You join others when an admin invites you. The workspace menu, from the logo at the top of the left rail, lists your workspaces and switches between them. It also holds Settings.

Joining a workspace gives you three things: the list of its members, the shared folders that include everyone, and a Private of your own. It shows you nothing of anyone else's Private, not even whether it holds anything.

Your Private

Your Private is where your notes start. A note made with no folder in front goes to Unsorted, which is in your Private, and so do your daily notes. Nobody else in the workspace sees what is in your Private, an admin neither, and neither do their agents. Your own agents see it, as they see what you see.

You can make folders in your Private and move things between them. Only you move anything into, out of, or within it.

To let one person into one note or folder in your Private, share it with them (see Share one note or folder).

Shared folders

A shared folder is a folder at the top of the workspace with members. Its members are either everyone in the workspace or the people it names, and everything inside it is shared the same way. Only a folder at the top can be shared.

  • An admin makes a shared folder for everyone.
  • An admin or an editor makes one that names people. Whoever makes it is in it, as an editor.

Run New shared folder from the command palette, or from the menu of Shared in the sidebar, its ... or a right click, then name it and choose who is in it and what they can do. Whoever can edit in a folder that names people changes who is in it from the folder's Share dialog.

Moving between your Private and a shared folder

Where a note lives decides who sees it, so moving it is how you share it or take it back:

  • Move a note or folder into a shared folder to share it with that folder's members.
  • Move it into your Private to make it yours alone again.

Before a move that changes who can see something, the app says who gains it or loses it, their agents too, and the move can be undone. Taking something out of a shared folder takes it from everyone there, so only an admin, or the member who made all of it, can do that.

Who can see a note

Each note's header says who can see it: Only you, Only you and Lin when you let Lin in, or the shared folder and its members, such as Team · Everyone · 5. A note that links to one in someone's Private shows the others "a private note", with no title.

Roles

Every member has one of three roles. A member's role is the most they can do in a shared folder, and a shared folder that names them can give them less.

Role Can
Viewer Read the notes in the shared folders they are in
Editor Also change notes and folders there, and make shared folders that name people
Admin Everything an editor can, and manage members, plugins, every shared folder, and every grant

An admin manages who is in every shared folder, even one they aren't in, without seeing what is in it. An admin can't read anyone's Private.

Any member can see who the other members are in Settings, under Members. A workspace always has an admin, so its only admin can't leave, be removed, or be given another role.

Invite someone

Only an admin can invite.

  1. Open Settings and go to Members, or run Manage members from the command palette.
  2. Under Invite someone, type the person's email and choose a Role.
  3. Press Invite.
  4. Copy the Invite link and send it to them.

Common Ink sends no email, so the link is how the person hears about it. The link admits only the email it was made for, whoever ends up holding it. Opening it signed out asks them to sign in, and brings them back to it. It shows them the workspace, the role and who invited them, and they become a member only when they press Accept, whether they had an account already or signed in for the first time to see it. Once they accept, it tells them they are in, which folders are shared with them, under Shared in the sidebar, and that their Private is theirs alone.

Someone who signs in without the link is still told: each time they open Common Ink while an invite waits for them, it shows a card saying who invited them and where, with Open invite, which goes to the link, and Not now, which hides that card in that browser until the invite is offered again. Neither joins them to anything. More than two invites waiting are one card, which opens the newest.

Pending invites are listed under Invited. Press Link to show an invite's link again, or Revoke… to take it back. Inviting the same email again changes the role offered.

Share one note or folder

To share a note, press Share… in the inspector's Info panel, choose Share… from the note's card menu in a folder's list, or run Share… from the command palette. To share a folder, choose Share… from the folder's menu in the sidebar.

In the Share dialog, type an email in Add a person by email, choose Can view or Can edit, and press Share. That access is a grant.

  • Can view lets them read the notes and their history.
  • Can edit also lets them change the notes and make new notes in a shared folder.

A grant on a folder covers its notes and the folders inside it. A grant on a note or folder inside it wins for that note or folder, whether it gives more or less. A grant made for an email that hasn't signed in yet waits for them.

What a grant does depends on where the note is:

  • In your Private, a grant is how you let someone in: a member, for no more than their role allows, or someone outside the workspace. Only you share what is in your Private, whatever your role.
  • In a shared folder, a grant on a member can only narrow what their role and the folder give them, and only an admin can narrow a member. Nothing narrows an admin. A grant to someone outside the workspace makes them a guest.

An admin or an editor who can edit a note in a shared folder can share it. A guest can't share, and neither can an agent.

Guests

A grant to someone who isn't a member makes them a guest. A guest sees the notes and folders granted to them and nothing else of the workspace. They don't see its other notes, its members, or how many of anything there are. Notes shared with a guest outside any folder they can see appear under Shared with me.

Mentioning someone in a note in your Private

When you mention a member in a note in your Private, a notice says they can't see the note and offers Share with them, which lets them read it. A mention by itself shares nothing. To turn the offer off, turn off Offer to share a private note with a member you mention in it in Settings, or set "mentions.offerToShare": false.

The Link section of the Share dialog makes an address that lets people read a note or a folder without being added. Choose who it opens for:

  • Anyone with the link
  • Anyone signed in to Common Ink with the link
  • Off

A link is read-only. Its page shows the note's text and no author, history, or backlinks. A note or folder has at most one link. Changing who it opens for keeps the address, and turning it off stops the address at once. A file has no link of its own, so a link on its folder is how to share it by link.

Manage sharing as an admin

Open Settings and go to Sharing. It lists every shared folder in the workspace, with who is in it and how many notes it holds, whether you are in it or not.

  • For a folder that names people, change what each one can do, take someone out, or add a member. A folder that names people always keeps someone who can edit in it.
  • Press Delete… on a folder that holds no notes. It is deleted only if nothing is left in it, archived or in Trash either.

You never see what is inside a folder you aren't in. Below the folders, Shared one by one lists every note and folder shared with a guest, narrowed for a member, or with a link, where you can take any grant back. What is in someone's Private isn't listed, unless it is yours or shared with you.

Leave a workspace

To leave, press Leave… on your own row in Settings, under Members. Before you confirm, it offers your Private as a download: the same kind of zip Export in Settings makes, of what is in your Private alone. Download it first if you want to keep it.

When you leave:

  • Your Private goes with you. Nobody in the workspace can open it, and anyone you let into something in it, or gave a link to it, loses it.
  • You can still download it for 30 days from Settings, under Account, in Taken with you. After that it is deleted for good.
  • What you wrote in shared folders stays, under your name.
  • You and your agents lose the workspace at once, and only an admin can bring you back.

If an admin invites you back within the 30 days, your Private is back as you left it, with nobody let in again. After that, you come back to an empty Private.

The workspace's owner can't leave until they make another admin its owner.

Remove a member

An admin removes a member with Remove… on their row in Settings, under Members. The member and their agents lose the workspace at once, and the grants that named them go with them.

Their Private goes with them, as it does when someone leaves. Nobody in the workspace can open it, admins neither, and it no longer counts toward the workspace's files. They can download it for 30 days from Settings, under Account, wherever they sign in, and then it is deleted. Anyone they let into something in it loses it. What they wrote in shared folders stays, under their name.

Sign out everywhere

A session lasts 30 days in one browser. To end every session you have at once, in every browser and every workspace:

  1. Open Settings and go to Account.
  2. Press Sign out everywhere….
  3. Leave Also disconnect my agents ticked to disconnect your agents too, or untick it to keep them.
  4. Press Sign out everywhere.

This signs out the browser you are using and your web clipper too. Agents use tokens, not sessions, so they stay connected only if you untick the box. See Agents.

An admin can do the same to a member with Sign out… on the member's row, with Also disconnect their agents. The member stays in the workspace and can sign in again. An admin can do this to a person once a day.