Skip to main content

Archive

Keep important clips separate from your active workspace. The archive provides long-term storage for clips you want to save but don't need cluttering your main gallery.

Why Use Archive?

  • Declutter: Keep your main gallery focused on active work
  • Organize: Separate reference material from transient clips
  • Find Later: Search works in the archive view just like in the main gallery

Archiving Clips

Single Clip

  1. Click the menu button (three dots) on the clip
  2. Select Archive
  3. The clip moves to Archive

Multiple Clips

  1. Select multiple clips using the checkboxes
  2. Click Archive in the bulk action bar
  3. All selected clips move to Archive

Viewing the Archive

Click the archive button in the header (box icon), or open the navigation drawer and click Archive. You can also press A to toggle between the main gallery and the archive view.

The archive view shows:

  • All archived clips in a grid
  • Same display format as main gallery
  • Search and tag filters work here too

Archive view

Unarchiving

Single Clip

  1. Open the Archive view
  2. Click the menu button (three dots) on the clip
  3. Select Restore
  4. The clip returns to the main gallery

Multiple Clips

  1. Select multiple archived clips using the checkboxes
  2. Click Restore in the bulk action bar
  3. All selected clips return to gallery
Bulk Restore Bug

The bulk archive operation currently always sets clips to archived (is_archived = 1) regardless of context. This means clicking Restore in the archive view re-archives the selected clips instead of restoring them. Use single-clip restore via the context menu as a workaround.

Archive Behavior

Expiration

warning

Archiving a clip does not remove any existing expiration. If a clip has an auto-delete timer, it will still expire even when archived. The cleanup job runs regardless of archive status. To keep an archived clip permanently, cancel its expiration first. See Auto-Delete for details.

Plugin Events

Archiving and unarchiving a clip emits plugin events (clip:archived and clip:unarchived). Plugins that subscribe to these events in their manifest can react to archive state changes.

All Features Available

Archived clips support the same context menu operations as active clips:

  • Open / Open With
  • Copy (Path, File, or Contents)
  • Save to disk
  • Edit (images and text)
  • Tags and Metadata
  • Rename
  • Set or Cancel Expiration
  • Delete

The search bar filters whichever view is currently active:

  • Main gallery clips when in gallery view
  • Archived clips when in archive view

It does not search across both simultaneously.

Use Cases

Reference Material

Store frequently-needed content:

  • Code snippets
  • Configuration templates
  • Image assets
  • API response examples

Important Screenshots

Preserve key screenshots:

  • Bug reports
  • Design mockups
  • Meeting notes
  • Documentation

Templates

Keep reusable content:

  • Email templates
  • Code boilerplate
  • Common configurations
  • Frequently-used text

Workflow Examples

Developer Workflow

  1. Paste code snippets during development
  2. Archive useful patterns for reuse
  3. Main gallery stays clean for active work
  4. Search archive when you need that snippet again

Designer Workflow

  1. Capture design variations
  2. Archive approved versions
  3. Compare against archive for consistency
  4. Keep working designs in main gallery

Writer Workflow

  1. Collect research and references
  2. Archive important sources
  3. Work with active materials in gallery
  4. Return to archive for citations

Tips

When to Archive

Archive content that:

  • You'll need again later
  • Represents completed work
  • Serves as reference material
  • Is too valuable to lose

When Not to Archive

Keep in main gallery:

  • Active working materials
  • Temporary transfers
  • Content with short-term relevance

Regular Maintenance

  1. Review main gallery periodically
  2. Archive valuable clips
  3. Delete unused clips
  4. Keep both views manageable

Naming

Provide meaningful filenames when importing (e.g., api-response-template.json). Good names make archive search more effective.

Cleanup

Review old archived clips periodically and delete truly outdated content.