iCloud Sync

Sync connections, groups, and tags to your Macs, iPhone, and iPad, and settings, table favorites, and SSH profiles between Macs

Sync needs a Starter or Team license and starts off. Press Cmd+,, open Settings > Sync, turn on Sync this Mac with iCloud, pick the categories, and click Sync Now. The iPhone and iPad app shares the same CloudKit data but carries connections, groups, and tags only.

iCloud Sync settings

What syncs

Each synced category has its own toggle under Sync Categories.

Data	Synced	Notes
Connections	Yes	Host, port, username, database type, SSH/SSL config, and whether the connection is a favorite
Passwords	Opt-in	Nested under Connections, and carried by Apple’s iCloud Keychain rather than TablePro’s own records. Turning it on affects new saves only, so re-save a password to sync it. On iPhone and iPad the same switch is Settings > iCloud > Sync Passwords
Groups & Tags	Yes	Nested group hierarchy and sort order included
SSH Profiles	Yes	Named SSH profiles
Credential Profiles	Yes	Between Macs only. Named credential profiles: the name, the username, and where the password comes from. Which connections use a profile is kept on each Mac
Table Favorites	Yes	The names shown in the Favorites tab and pinned in table lists
Table Folders	Yes	Between Macs only. The sidebar’s folders and the tables and views filed in them
Database Favorites	Yes	Favorited databases and their Development / Testing / Production tags
Saved Queries	Yes	Saved SQL and their folders
Settings	Yes	Between Macs only. General, Appearance, Editor, Data Grid, History, Tabs, Keyboard, and AI settings, plus custom AI slash commands and saved per-table column widths and order
Linked SQL Folders	No	Folder paths are per-Mac. Link the same Git repo on each Mac after cloning. The cached file index stays local too
Sidebar state	No	The sidebar’s database filter and recent tables lists stay on each Mac
Connection list order	No	Recent connections and whether that section is shown, the sort order, and the order of favorites stay on each device

A sync runs at launch, when you switch back to the app, 2 seconds after you change anything synced, and when the network returns after a sync that could not reach iCloud.

Keeping a connection off iCloud

A localhost or throwaway database is rarely worth a round trip. Mark it Local only under iCloud Sync on the connection form’s Options tab, or right-click it and choose Exclude from iCloud Sync. It shows a struck-through cloud icon in the connection list, and the flag survives duplicating and exporting.

What belongs to the connection stays on this Mac with it: its table and database favorites, the saved queries and folders scoped to it, and its column widths, order, and hidden columns. Edits and removals you make to them wait here while the connection is Local only, and the first sync after you turn it off sends them. Deleting a Local only connection removes those items from this Mac and from nowhere else.

Checking that it worked

Status in the Sync Status section reads Up to Date after a clean run. Last Synced is the last run that both sent this Mac’s changes and brought the other devices’ in, so it stops moving while uploads fail even though downloads keep arriving.

When the same connection changed on two devices, TablePro merges field by field, so a name edited on one Mac and a port edited on the other both survive. When one field changed in both places, the device that syncs last wins.

Troubleshooting

A condition that a retry cannot clear shows as a notice at the top of Settings > Sync, with the action that clears it. While it lasts, edits stop going up on every change: they wait on this Mac, and nothing local is deleted. The welcome window’s sync indicator names the same condition and opens the pane when clicked.

iCloud Storage Is Full

Every upload fails, deletions included, until iCloud has room. Changes from your other devices still arrive. Click Manage Storage…, or open System Settings, click your name, then click iCloud, and free up space or add storage. The upload is tried again after 5 minutes, then twice as long each time up to an hour; click Sync Now to try at once.

Not Signed In to iCloud

No Apple Account is signed in to iCloud on this Mac. Click Open System Settings… and sign in. Sync starts by itself once you do.

iCloud Is Not Ready

The account is signed in, but iCloud is not ready for apps yet, which happens briefly after signing in. Sync resumes by itself. If the notice stays, look in System Settings > Apple Account for a prompt to confirm your password.

iCloud Is Restricted

Screen Time or a device management profile does not allow iCloud on this Mac. Sync stays off until whoever manages the Mac lifts the restriction.

TablePro Data Was Removed from iCloud

TablePro’s data is no longer in iCloud, most often because it was deleted under Manage Storage. Nothing uploads until you choose: Upload Again sends everything on this Mac back up, and Turn Off Sync keeps it on this Mac only. If another device uploads first, this Mac picks that up and syncs normally again.

Update Required

iCloud no longer accepts this version of TablePro. Click Check for Updates… and install the update.

Offline

iCloud could not be reached. Changes go up as soon as the network returns, without a click.

Waiting to Retry

iCloud asked TablePro to slow down. The next attempt waits for the time iCloud named, and at least 30 seconds.

Some Changes Not Uploaded

iCloud refused the changes counted under Sync Now and accepted the rest. The refused ones stay on this Mac and go again on the next sync.

Other cases

Signing in to a different iCloud account starts sync over for that account: the next sync is a full fetch rather than a delta, and changes waiting on this Mac go to the new account. Expect the first sync to take longer.

When a license expires, sync stops and local data stays where it is. Re-activate to resume.

A license TablePro has not been able to check for 30 days pauses sync separately, under Sync Paused rather than Sync Off. Click the indicator, or Check Again in Settings > Sync, to try the server again. Local data stays where it is either way.