Block Actions
Heaper provides several actions you can perform on blocks, either individually or in bulk through multi-selection.
Pin / Unpin
Pin blocks to keep them easily accessible in the sidebar.
- In the action sidebar, click the pin/unpin icon on a selected block
- Pinned blocks appear in the sidebar for quick navigation
- Pinned blocks also show up as quick-access tags in the radial drag menu
- Right now only single blocks can be pinned after another (not bulk selections) *This is to not spam the sidebar with accidental pins, These are your top level blocks which you sort everything else into. *
Download
Download the original file for any file-type block:
- Select a block and use the download action in the selection sidebar
- Files are downloaded in their original format and quality
Show in Finder / File Manager
For file blocks that reference local files:
- Right-click on a file in quick preview → "Reveal in Finder" (macOS), "Open in Explorer" (Windows), or "Open in File Manager" (Linux)
- Right-click → "Open with Default App" to open the file in its associated application
This is available on the desktop app.
Export
Export blocks for use outside Heaper:
- The export dialog supports bulk export of selected blocks
- Available from the selection sidebar when blocks are selected
Notes on Images
You can add notes and annotations to image blocks:
- Open an image block, Then press the note icon on the right top side of the bottom sheet. This will swap the image with the note, and you get a full rich text editor to add any context you need.
- Notes are stored as part of the block's CRDT document, so they sync across devices
Share (Mobile)
On mobile (Capacitor), you can share blocks to other apps:
- Select a block and use the share action
- Choose between sharing as text, file or preview
- Uses the native share sheet on iOS and Android
Batch Actions
When multiple blocks are selected, the selection sidebar shows batch operations:
- Tag / Mention — Apply tags or mentions to all selected blocks
- Delete — Move all selected blocks to trash
- Common tags — View and manage tags shared across the selection