# Data & Storage

The Locations settings pane gives you visibility into where Weavestream stores data and how much space it's using. Open it from Settings (Cmd+Comma) and select the Locations tab.

# Storage Locations

# App Data

Weavestream stores all your data (items, conversations, source configurations) in a local database on your Mac. The Locations pane shows:

  • Database location — The file path where the database is stored
  • Database size — How much disk space the database currently uses

# Workflows

Workflow definitions are stored separately. The Locations pane shows the workflow storage directory.

# Item Counts

The Locations pane shows a breakdown of how many items are stored per endpoint. This helps you understand which endpoints are contributing the most to your database size.

If a particular endpoint has accumulated a large number of items, you might consider:

  • Changing its retention mode to Delete on Sync or Archive on Sync
  • Reducing the Max Items in its pagination settings
  • Adjusting its refresh interval

# Data Repair & Cleanup

The Locations pane includes options for maintaining your database:

  • Repair — Fixes any database inconsistencies. Use this if you notice items missing, duplicated, or displaying incorrectly.
  • Cleanup — Removes orphaned data and optimizes the database. This can reclaim disk space if you've deleted sources or endpoints.

These operations are safe and non-destructive — they fix and optimize but don't remove your valid data.

# Tips

  • Database size grows over time if you use the "Keep All" retention mode. Check the size periodically if disk space is a concern.
  • Cleanup after deleting sources. When you remove a source, running cleanup ensures all associated data is fully removed.
  • Back up important data. While Weavestream's database is reliable, it's always good practice to export critical data using the Save File workflow node or by copying item JSON manually.