Deleting Blocks & Trash

Heaper uses soft deletion — when you delete a block, it's moved to trash rather than permanently removed. This gives you a safety net to recover accidentally deleted content. When a block is in the trash all the connections to it are not shown on other blocks but they are still persisted in case you want to recover the item from the trash. So it, including all of its connections, get restored. Only once you empty the trash and thus permanently delete the block these connections, as well as local files files on the server and any metadata will get destroyed.

Deleting Blocks

Single Block

1. Select the block you want to delete
2. In the action sidebar, click Move to Trash
3. Confirm the deletion in the confirmation dialog

Multiple Blocks

1. Select multiple blocks (Ctrl/Cmd+Click or Shift+Click)
2. In the action sidebar, click Move to Trash
3. Confirm to delete all selected blocks

What Happens When You Delete

When a block is moved to trash:

• The block is marked as deleted (soft delete)
• its local file get removed (if backed up to a server)
• It's removed from all views, the sidebar, and search results
• Its relations (tags, mentions) are disabled
• This syncs across devices

Recovering Deleted Blocks

In the left sidebar, you can open the trash with a toggle and select Restore on any entry that you'd like to recover. This will restore all connections, metadata, and file, as these were just disabled while it was in the trash. This will sync to all devices.

Permanent Deletion

To permanently delete, you can in the left sidebar go to the trash and press empty trash. You will get a hint which blocks will have their mentions removed as well.