Fix offline sync and common app errors

Use this guide to troubleshoot:

1. Offline or no internet messages.
2. Sync in progress or stale data.
3. Changes that do not appear on another device.
4. Save, upload, share, or provider retry prompts.
5. No access, not found, or upgrade prompts.
6. Public links that cannot be updated while offline.

Terms you may see:

• Offline state means network-dependent actions may pause or fail.
• Sync sends and receives updates between your device and shared app data.
• Stale data can happen briefly when sync is still catching up.
• Permission errors are different from network errors.
• Plan-limit errors require billing or usage review, not repeated retries.
• Provider errors can affect calendar, login, or integration actions even when the app itself is online.

Before you start

• Know whether the device is online.
• Know which Space and item you were using.
• Note the exact action that failed.
• Keep the app open long enough for sync to complete after reconnecting.
• Copy critical text before refreshing if a save repeatedly fails.

How app navigation works

1. The app tracks network state and sync state.
2. Some local or cached data may remain visible while offline.
3. Shared changes wait for a stable connection before they can appear everywhere.
4. Permission and plan checks can still block actions when online.
5. Provider handoffs may need a browser, account consent, or reconnect.
6. Refreshing or retrying should happen after confirming the likely cause.

Expected outcome: You can decide whether to wait for sync, retry after reconnecting, check access, check billing, reconnect a provider, or report the issue.

Error Reference

Message or state	What it usually means	What to do first
No internet / offline	Network-dependent action cannot save now.	Reconnect and retry once.
Syncing	The app is sending or receiving updates.	Wait briefly before refreshing.
Save failed or retry	The update did not complete.	Check network, permissions, and required fields.
Upload failed	File, image, or attachment did not upload.	Check network and file access, then retry once.
Not found / 404	Link, item, or page cannot be located.	Check account, Space, item state, and link freshness.
No access	Your account or role cannot use the action.	Check membership, role, private access, and App Settings.
Upgrade or usage prompt	Plan availability or usage limit is blocking the action.	Ask a billing admin to review Billing and Usage.
Public link update failed	Sharing requires connection and settings access.	Reconnect, confirm access, then copy the link again.
Provider connection failed	Calendar, login, or integration handoff did not complete.	Confirm the provider account, browser handoff, consent, and redirect.

When the app says you are offline

1. Check your device connection.
2. Reconnect to the internet.
3. Keep the app open until sync resumes.
4. Retry the action only after the connection is stable.
5. Avoid repeated edits to the same item from multiple devices while offline.

When changes do not appear

1. Confirm you are in the correct Space and view.
2. Clear filters that may hide the item.
3. Wait for sync if the app shows syncing or retrying.
4. Refresh after sync completes.
5. Check another device only after sync is complete.

When save or upload retries

1. Do not close the app immediately.
2. Check network and file permissions when the failed action includes an attachment or image.
3. Retry once after reconnecting.
4. If it still fails, copy critical text before refreshing.
5. Report the issue with the item type and action.

When no access or not found appears

1. Confirm the signed-in account.
2. Confirm the active Space.
3. Ask an owner/admin to confirm your role and item access.
4. Check Archived or Recently Deleted if the item used to exist.
5. See Troubleshoot access and permission issues.

When an upgrade or usage prompt appears

1. Confirm the feature name and action.
2. Open Billing or ask a billing admin to check the plan.
3. Review Usage if a limit is involved.
4. Do not keep retrying if the app says usage is exceeded.

Troubleshooting

Sync keeps running

• Symptom: Sync appears to continue for a long time.
• Cause: The app may be processing a large update, reconnecting, or retrying after a network interruption.
• Resolution:
  1. Keep the app open for a short period.
  2. Confirm network stability.
  3. Refresh only if the app remains stuck.
  4. Report the issue if sync repeatedly fails on the same Space.

A change appears on one device but not another

• Symptom: One device shows the update and another does not.
• Cause: One device may be offline, stale, or signed in to a different account.
• Resolution:
  1. Confirm both devices use the same account.
  2. Confirm both are in the same Space.
  3. Wait for sync on both devices.
  4. Refresh the stale device.

Retry does not fix the problem

• Symptom: Repeating the same action keeps failing.
• Cause: The issue may be access, plan limit, provider connection, invalid data, or item state rather than network.
• Resolution:
  1. Stop repeated retries.
  2. Check whether the action is disabled for your role.
  3. Check Billing, App Settings, or Integrations if relevant.
  4. Report the issue with the exact message and action.

FAQ

Can I keep working offline?

Some views and cached data may remain usable, but actions that require shared sync, billing, integrations, public sharing, or provider authorization need network access.

Should I refresh when sync is running?

Wait briefly first. Refreshing too early can make it harder to tell whether the app was still saving or genuinely stuck.

What should I include in an error report?

Include account email, Space name, item type, item name or link, action attempted, network state, device/browser, and the exact message shown.