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