iCloud sync and backups
iCloud sync
HandyPaste syncs your snippets, folders, variables and Recently Deleted between your Macs through your own private iCloud database. There's nothing to sign up for: any Mac signed in to the same Apple Account gets the same library.
Sync is on by default. Check its status in Settings ▸ iCloud, which says in plain words whether sync is working, and when it last synced.
To turn it off, uncheck Sync snippets with iCloud. The change takes effect when HandyPaste restarts, and it offers to restart right away. Your snippets stay on this Mac.
Why doesn't HandyPaste add examples on its own?
Sample snippets added automatically on first launch would be added again on every Mac and multiply through sync. That's why examples come from a button (Add Examples in an empty library) that you press once.
If sync isn't available
Settings ▸ iCloud tells you why:
- Sign in to iCloud in System Settings: the Mac isn't signed in to an Apple Account. Sign in, and your library syncs from then on.
- iCloud is restricted on this Mac: a management profile or Screen Time blocks iCloud.
Without sync, HandyPaste works exactly the same. The library just stays on this Mac.
Export and import
Export saves your whole library (folders, snippets, keywords, favorites and variables) to a .handypaste file. Inside, each snippet is a plain text file, so your snippets stay readable even without HandyPaste. Import adds the snippets from such a file.
- Export: File ▸ Export Snippets…, or the same button in Settings ▸ Backup
- Import: File ▸ Import Snippets…, or the same button in Settings ▸ Backup
You can also double-click a .handypaste file in Finder: HandyPaste says how many snippets it holds and asks before importing.
Import adds snippets and never overwrites what you have, and skips snippets you already have. It also reads older .json backups, from HandyPaste 1.0.x and from the HandyPaste Chrome extension. The free version's limit never applies to importing.
Settings ▸ Backup also shows how much your library holds and when you last exported it from this Mac.
Where your library is kept
- On your Mac, inside HandyPaste's app container. Time Machine backs it up along with everything else.
- In iCloud, if sync is on, which also keeps it safe if a Mac is lost.
- In your exports, wherever you save them.
An export now and then is still a good idea, for example before a big reorganization, or to share a set of snippets with a colleague.
Sharing snippets with a team
Export your snippets, send the file, and your colleagues import it. Imports are added next to what they already have, so nothing of theirs is replaced.