Skip to main content

Overview

When iCloud Documents syncing is enabled on your Mac, the Superwhisper folder may move to iCloud while the app still references the original location. This mismatch prevents Superwhisper from saving new modes and can cause other problems.
This mainly affects older installs where the Superwhisper folder lived in ~/Documents. The current default is ~/superwhisper in your home directory, which iCloud Documents syncing doesn’t touch.

Fix the folder location

Redirect Superwhisper to a folder outside iCloud:
1

Open the Configuration Tab

Access the Configuration section from the left sidebar menu in Superwhisper and go to “Advanced Settings.”
2

Change Folder Location

Scroll down to find the “Change Folder” option and click it.Superwhisper Folder Location
3

Select a New Folder Location

In the file browser that appears, navigate to your home folder (or another location outside iCloud) and click “Open”.
4

Confirm the Change

Click “Confirm” in the dialog box to apply the folder location change.
Superwhisper now references the new location, and modes save normally again.

Modes missing on iPhone or another Mac

Modes and vocabulary don’t sync between devices by default. On Macs, enable Filesync on each install under the same license to sync configuration. Windows and iOS sync aren’t available yet: recreate your most-used modes there, or back up and copy the Superwhisper folder between computers.