Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 7 additions & 7 deletions features/icloud-sync.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,8 @@ description: Sync connections, groups, tags, and saved queries to your Macs, iPh
Sync needs a Starter or Team [license](/features/licensing) 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.

<Frame caption="iCloud Sync settings">
<img className="block dark:hidden" src="/images/settings-sync.png" alt="Sync pane with the Sync this Mac with iCloud switch and its Starter badge" />
<img className="hidden dark:block" src="/images/settings-sync-dark.png" alt="Sync pane with the Sync this Mac with iCloud switch and its Starter badge" />
<img className="block dark:hidden" src="/images/settings-sync.png" alt="Sync pane with the Sync this Mac with iCloud switch dimmed above a row that names the plan and offers Activate License" />
<img className="hidden dark:block" src="/images/settings-sync-dark.png" alt="Sync pane with the Sync this Mac with iCloud switch dimmed above a row that names the plan and offers Activate License" />
</Frame>

## What syncs
Expand Down Expand Up @@ -49,11 +49,11 @@ When the same connection changed on two devices, TablePro merges field by field,

## 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.
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 **Sync Now** to try at once.
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

Expand All @@ -69,7 +69,7 @@ Screen Time or a device management profile does not allow iCloud on this Mac. Sy

### 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.
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

Expand All @@ -91,6 +91,6 @@ iCloud refused the changes counted under **Sync Now** and accepted the rest. The

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.
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 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.
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.
12 changes: 6 additions & 6 deletions features/licensing.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -11,10 +11,10 @@ There are two tiers, Starter and Team. Team includes everything in Starter.

| Feature | Required tier | Without a license |
|---------|---------------|-------------------|
| [iCloud Sync](/features/icloud-sync) | Starter | Dimmed, with a **STARTER** badge |
| [Encrypted connection export](/features/connection-sharing) | Starter | Dimmed, with a **STARTER** badge |
| [iCloud Sync](/features/icloud-sync) | Starter | Dimmed, with a row naming the plan and **Activate License…** |
| [Encrypted connection export](/features/connection-sharing) | Starter | Dimmed, with a row naming the plan and **Activate License…** |
| [Environment variables in connection fields](/features/connection-sharing) | Starter | References stay unresolved |
| [Linked Folders](/features/connection-sharing) | Starter | Dimmed, with a **STARTER** badge |
| [Linked Folders](/features/connection-sharing) | Starter | Dimmed, with a row naming the plan and **Activate License…** |
| [Query Insights](/features/query-insights) | Starter | Overlay with **Activate License…** |
| [Result charts](/features/data-grid#chart-mode) | Starter | Overlay with **Activate License…** |
| [Compare & Sync](/features/compare-sync) | Starter | Dialog naming the requirement |
Expand All @@ -24,7 +24,7 @@ There are two tiers, Starter and Team. Team includes everything in Starter.

**Settings > License** lists these features under **Starter Plan** and **Team Plan** and marks each plan your license includes. On a Starter license, **Upgrade Plan** sits beside **Team Plan**. Everything else in the app works.

Click a badge for the pricing page, or hover it for one line on what the feature does.
The **Activate License…** dialog also links to the pricing page. A license you already hold never gets that offer: every gate says what the top of **Settings > License** says for its state, so an expired license offers **Renew License**, a suspended one says so, and one that has not reached the server in 30 days offers **Try Again**.

## Buy a license

Expand Down Expand Up @@ -53,7 +53,7 @@ It waits out the first five minutes after launch and any running query, and appe

Open **Settings > License** (`Cmd+,`), paste your license key (`XXXXX-XXXXX-XXXXX-XXXXX-XXXXX`), and click **Activate**.

The welcome window has an **Activate License** link to the same dialog until a license is active. When the license has not been checked in 30 days, an orange **Starter** or **Team** badge takes its place; the link does not come back, because activating again cannot help a Mac that is offline. The field also takes a team invite code, which TablePro tells apart from a key on its own. See [Team Plan](/features/team).
Without a license, the welcome window has an **Activate License** link to the same dialog. With one, the link names the license's state whenever the pane would: **License Expiring Soon** and **License Expired** open the renewal page, **Could Not Check This License** opens **Settings > License** and checks again, and **License Suspended** or **License Removed** opens the pane. The field also takes a team invite code, which TablePro tells apart from a key on its own. See [Team Plan](/features/team).

<Frame caption="Settings > License with a license active">
<img className="block dark:hidden" src="/images/license-settings.png" alt="A license pane listing email, a masked key, plan and expiry above a list of activated Macs" />
Expand Down Expand Up @@ -83,7 +83,7 @@ Activation stores a signed license on your Mac, and the license key goes to the
- If the server is unreachable, the license keeps working for 30 days after the last successful validation. After that the pane says **Could Not Check This License** and offers **Try Again**, and paid features pause until a validation succeeds. Nothing in that state asks for a license key: the way out is a working connection.
- If the server answers that the license is suspended, expired, or no longer activated on this Mac, paid features pause at that check. The 30-day grace period only covers a server TablePro could not reach.

**Refresh** in **Settings > License** re-validates with the server and reloads the device list, and a gated screen offers **Retry Validation**. Inside the last week before expiry, the pane carries a renewal notice linking to tablepro.app.
**Refresh** in **Settings > License** re-validates with the server and reloads the device list, and a gated screen or row offers **Try Again**. When a check cannot reach the server, the reason shows under the button and stays until a check succeeds. Inside the last week before expiry, the pane carries a renewal notice linking to tablepro.app.

## What syncs

Expand Down
Binary file modified images/settings-sync-dark.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified images/settings-sync.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading