Tagging & Selection

Tagging is the primary way to organize blocks in Heaper. You can tag blocks one at a time or in bulk using keyboard shortcuts, the quick preview overlay or inside app views

Selecting Blocks

Selection Mode

When you enable the select mode, you can click a block to select it. You can also shift-click an entry to start the select mode and select it instantly, or drag horizontally over an element to start a selection range.

Multi-Select

• Ctrl/Cmd + Click — Add or remove individual blocks from the selection
• Shift + Click — Select a range of blocks
• Long Press — On touch devices, long press (450ms) opens the radial drag menu on the left is the option to select the dragged block

Grid Selection

In grid view, You can swipe over the blocks you want to select horizontally and then continue dragging to select more of them. A count indicator shows how many blocks are selected. You can also use the arrow keys to navigate your highlighted block and press C to select the currently highlighted block.

List/Tasks Selection

In the Lists app, you can use the arrow keys to navigate up and down for the highlighted block and press C to select the currently highlighted block. You can also enter the selection mode and then drag over a range or press shift to select a range of blocks.

Tagging with Keyboard

Pressing T opens the tag menu where you can type to search for existing tags or create new ones.

Radial Drag Menu

The radial drag menu is a quick-action interface that appears when you long-press on a block (or press and hold on touch devices).

How It Works

1. Long-press on a block — the radial menu appears centered on your press point
2. Three action buttons arc above:
   • Select (checkbox icon) — Toggle selection
   • Preview (eye icon) — Open quick preview
   • More Tags (tag icon) — Open full tag picker
3. Recent tags appear as a cloud below — drag toward one to apply it
4. Current tags appear above — drag toward one to remove it

Multi-Block Tagging

When multiple blocks are selected, the radial menu shows a fanned stack of thumbnails (up to 3) with a count badge. Applying a tag through the radial menu applies it to all selected blocks.

Removing Tags

Existing tags/mentions on the block (or common tags across a multi-selection) are displayed above the action buttons. Drag toward a tag chip to remove it.

Tagging from Quick Preview

While in the quick preview overlay:

• Press T to tag the currently viewed block
• Press Shift+T to tag all selected blocks

Tagging from Search

In global search, highlight a result and press Shift+Enter to apply it as a tag. See Global Search for details.

Pinned Block Tags

Blocks you've pinned appear as quick-access tags in the radial menu's tag cloud (up to 5 most recent). Pin frequently used tags for fast access.

Tagging from the Sidebar

At the top of the selection sidebar, which you can open with the rightmost navigation bar icon, you can press the mention or the tag icon. To tag an element with whatever block you search for or create. This works for both selected ones or the current one depending on if a selection exists. The priority here is first tagging all the selected items and if none of them exist it tags the current block. we're on This is also shown at the top of the action sidebar.

Once you have tags on your selection, you can modify these from the right sidebar as well. There all the common different tags or mentions are listed in these groups and you can either apply a tag that's not on all of them to all of the blocks in the selection or remove them from the selection. This works also for things that are on every block. This lets you easily manage complex tasks for selected blocks. You can also convert a mention to a tag and vice versa.