Installation & Updates

Reset Franz user data on macOS

Reset Franz user data on macOS by backing up app-state files, clearing local partitions, and understanding what each folder stores before restart.

Back to Support

Reset Franz user data on macOS

Franz stores local desktop data in ~/Library/Application Support/Franz. This folder contains app state, service partitions, cache data, and local browser storage used by the services you added. Your Franz account, subscription, and synced service list are tied to your account. Messages and provider-side data remain with WhatsApp, Slack, Gmail, Signal, and the other services themselves.

Use this reset only when Franz opens to a broken state, services stay blank after reload, a window state is corrupted, or a service keeps a bad local session. Quit Franz completely before changing files. If Franz is still visible in the menu bar or Dock, quit it there too.

First reset the app state. Open Finder, choose Go to Folder, and enter ~/Library/Application Support/Franz. Create a folder named Franz recovery backup on your Desktop. Move app-state.json and app-state.json.backup into that backup folder if they exist. Start Franz again. This forces Franz to rebuild local shell state while keeping heavier service data in place.

If the app opens correctly after this step, sign in if prompted and let sync repopulate your services. Keep the backup for a few days, then delete it once everything is stable.

If services are still broken, quit Franz again and return to ~/Library/Application Support/Franz. Move the partitions folder into the Desktop backup folder. Partitions contain the Electron browser storage for individual services: cookies, local storage, cache, and service worker data. Removing them signs services out and clears bad web state without deleting your Franz account.

Restart Franz after moving partitions. Open each service and sign in again where needed. If only one service is broken and you know its partition folder, you can move only that partition instead of the entire folder. When the issue is fixed, delete the backup. If the reset did not help, move the backed-up files back while Franz is quit.

Stay in the loop

Product updates from the Franz team every 2–4 weeks — tips, new features, and release notes.