iCloud Sync

Sync needs a Pro 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, tags, and saved queries only.

​

What syncs

Each synced category has its own toggle under Sync Categories. Turning one on brings down what other devices added or changed while it was off, but not what they deleted: remove those items on this Mac too. 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. A custom theme travels as its file. Moving one to the Trash on one Mac moves it to the Trash on the others. A theme file copied into the Themes folder in Finder goes up the next time you edit it in TablePro or turn sync on. A Mac on an earlier version of TablePro switches its Appearance to System when a theme choice arrives from an updated Mac.

​

Sign-ins on another Mac

Before an imported or synced connection uses this Mac’s cloud credentials or Kerberos tickets, review Sign In with Credentials from This Mac?. The dialog names the destination and sign-in method. Click Sign In to approve that use. Links, Linked Folders and Team Library connections follow the same rule. Approval stays on this Mac and covers the connection, destination and sign-in settings shown. A new destination or added credential use asks again. A background reconnect cannot grant approval: open the connection yourself to review it. Connections that use environment variables also need approval on each Mac.

​

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. Its title also shows as a link on the welcome window that opens the pane, except iCloud Is Not Ready, which clears by itself. While it lasts, edits stop going up on every change: they wait on this Mac, and nothing local is deleted.

​

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 Try Again in the notice 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 iCloud 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. With an update already waiting, the button reads Update Available… or Relaunch to 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. The switch dims, and the row under it offers Renew License. A license that has not reached the license server in 30 days pauses sync the same way. The row under the switch says Could Not Check This License and offers Try Again; a check that fails again says why under the button.