Sharing
You can share a whole heap, or just one note or file with everything inside it. Sharing needs a heap that syncs with a server: Heaper Cloud or your own server. A heap that lives only on your device can't be shared until you add sync to it.
People you share with see changes live and can work offline. Everything merges when they reconnect.
Which kind of sharing do I need?
| You want to… | Use |
|---|---|
| Work together in the whole heap | Invite people to the heap |
| Give someone access to one project, note or folder | Share a single block |
| Let someone without Heaper download files | Create a download link (coming soon) |
| Send a note or file to someone outside Heaper | Share to another app or export |
| Point a teammate to something they already have access to | Copy a Heaper link |
Inviting people to a heap
- In the left sidebar, open the heap menu and select Invite others to this heap. Once people have joined, it reads Shared with N people.
- Select Invite.
- Define scope: choose Whole heap, or Start from a block to share only part of it.
- Define role: choose what they can do. See Roles.
- Invite method: choose how the other person receives access:
- Handle or email: someone with a public handle, or a private invite tied to their email address
- Existing account: someone who already has an account on the same server
- Public key: a one-time invite for a specific key
- Invite code: a code you send them yourself. Choose One-time, Limited or Unlimited uses, and optionally an expiry date.
- Send them the invite details. Copy all invite details copies everything they need.
Heaper does not send emails for you. Send the invite code or link through any channel you like.
Only owners and admins can invite people. Pending invites are listed in the same dialog, where you can copy or Revoke them.
Accepting an invite
- New to Heaper? During setup, choose Invited heaps or Use invite code and paste the code.
- Already using Heaper? Open Settings → Account → Servers and sharing → Invited heaps and select Accept and pull. The heap downloads to your device.
- Got a link? Opening an invite link shows a Workspace invite page with an Accept invite button.
Sharing a single note or file
Sharing part of a heap is in beta since Heaper 16.22. See Current limits.
Any block can have its own access, for example one client project inside your work heap. With This block and everything inside, this also covers everything under a tag or inside a folder.
- Open the block and open the right sidebar.
- Find Share and access.
- Under People with custom roles, select Add person, group or email… and pick a role.
- Under Applies to, choose This block only, This block and direct children or This block and everything inside.
- Select Save access changes and confirm.
The Share and access panel shows up when exactly one block is open or selected.
To hide a block from people who can otherwise see the whole heap, set General access to Restricted. Then only the people and groups you add, plus owners and admins, can open it.
The panel also shows Your access, so you can check what you can do yourself.
Roles
| Role | Can… |
|---|---|
| Viewer | Read what is shared with them |
| Commenter | Read, and add comments where supported |
| Editor | Create and edit everything they can access |
| Admin | Do everything, including managing members and sharing |
Two rules apply on top of roles:
- Owners and admins always have full access.
- No access wins over every other role. Use it to hide one block from someone.
Manage members, groups and roles in Team & Access.
Download links
Coming soon. Download links are part of an upcoming Heaper release. They work on Heaper Cloud and on your own server once it runs that release.
A download link is a web address you can send to anyone. They open it in any browser, without a Heaper account or the app, and download the files you chose. It's a quick way to hand over photos from your own server, deliver files to a client, or collect a folder for a friend.
Creating a link
- Open the block you want to share from, and open the right sidebar.
- In the Sharing section, select New download link.
- Under Share, choose:
- This block: the block's own files, and its text as a note
- Tagged blocks: everything tagged with this block, like a folder
- Under Include, switch Files, Notes and Artifacts on or off. Expand a group to check only some items. Artifacts, such as recognized text and saved web pages, stay off unless you turn them on.
- Under Version, choose:
- This version: exactly these files. Later uploads are not shared.
- Latest version: the link follows new uploads and new versions.
- Optionally set Expires (1, 7 or 30 days, or never) and a Download limit.
- Select Create and copy link, then send the link however you like.
With Tagged blocks, everything checked and Latest version, whatever you tag later also becomes downloadable through the same link. Untagging a file removes it from the link.
What the recipient sees
A simple page with your name, the number of files and their total size. They can preview photos, videos and notes, download single files, or select several and download them as one zip. Notes download as web pages. Large zips can resume if the connection drops.
The page never opens your heap. Recipients can't see other notes, tags, comments or who else has the link.
Keeping track
- While Heaper is open, it tells you when someone finishes a download, for example "sunset.jpg was downloaded".
- Settings → Heaps → Download links lists all links of the heap, active and Expired & revoked, with every completed download.
- Copy link copies an active link again.
- Replace link creates a new address and stops the old one. Use it if a link was sent to the wrong person.
- Revoke stops a link right away, even downloads that are still running.
A link stops working when it expires, reaches its limit or is revoked. It also stops if you lose access to the files yourself. You need to be allowed to download and export a block to create a link for it.
Sending to other apps
On iOS and Android, open a block, select Share and choose Share as text or Share file. This opens your phone's share sheet, for messages, email or any other app.
On any device you can download the original file or export selected blocks.
Heaper links
In a block's … menu, Copy Heaper Link copies a link that opens this block directly in the Heaper app. It only works for people who already have access to the block.
Current limits
Sharing part of a heap is new. Keep these limits in mind:
- Everyone needs Heaper 16.22 or newer. That includes your own server. Once a heap uses per-block access, older apps can't sync it until they update.
- Access is per block. A shared note always includes all its text and its version history. You can't share only one paragraph or one property.
- Commenter works like Viewer for now. Comments are still an early feature that most people can't turn on yet.
- Removing access can't take back copies. Files someone already downloaded or exported stay with them. A device that is offline keeps its copy until it reconnects. To limit this, turn on expiring offline access.
- Only owners and admins manage access, and only while online. You can't yet make someone an admin for just one part of a heap.
- Editors can't move blocks into or out of an area with different access.
- Groups can't contain other groups. Company sign-in (SSO) isn't supported.
Download links have their own limits:
- Tagged blocks includes only blocks tagged directly with this block, not the contents of nested tags.
- A note in a This version link still shows the note's current text.
- One link can hold up to 1,000 items.
Public sharing
Apart from download links, Heaper does not have public web pages or view-only links for people without an account yet. To show a note to people without a Heaper account, export it or share it as a file.