Sync failure banner — what to do

If a cloud sync fails, you might see a banner at the top of the screen — typically “Sync failed. Tap to retry.” Here’s what it means and how to resolve.

What causes sync failures

The most common reasons:

No internet — Your device isn’t connected.
Slow or unstable connection — Network is up but not reliable.
Our servers having an issue — Rare, but possible during a deploy or outage.
Authentication expired — Very rare; your sign-in session may have lapsed.

A small banner near the top of the screen:

Color: Red or amber.
Text: “Sync failed. Tap to retry.”
Possibly an icon (warning triangle or refresh).

Tap it to retry. The banner dismisses itself after a successful retry.

How to resolve

Step 1 — Check your internet

Open another app that uses internet (web browser, email). If those work but Manga Vault doesn’t sync:

Force-close Manga Vault and reopen.
Try the retry banner again.

If other apps don’t have internet either:

Check your WiFi or cellular connection.
Toggle airplane mode off then on.

Step 2 — Force-sync from Settings

If retries from the banner aren’t working:

Open Settings.
Tap Catalog Version in the About section to trigger a sync (this also forces an account data sync).

Step 3 — Sign out and back in

If sync remains broken:

Settings → Sign Out.
Sign back in with your email and password.
Initial sync should pull your data fresh.

This resets the local sync state.

Step 4 — Contact support

If sync is still failing after trying the above, contact support with:

Your email address.
The specific error message (screenshot helps).
Your App Version and Catalog Version.

Pending changes during sync failure

If you’ve made changes (added a volume, updated reading progress, etc.) and sync failed, those changes are saved locally. They aren’t lost — they queue up as pending changes.

When sync recovers, your pending changes upload automatically.

You can keep using the app even with sync failing. Changes accumulate locally and sync later.

Sometimes a sync retries automatically and recovers within seconds. The banner might flash briefly during the retry — that’s normal.

Persistent failures are what to worry about; brief flashes are fine.

”Auth required” or “Session expired”

If the error mentions auth or session:

Sign out.
Sign back in.

Your session may have expired (rare; usually after 30+ days idle).

Server-side issues

Very rarely, our backend services have a brief outage. If you suspect this:

Wait 5–10 minutes.
Try again.
Check our status page (when available) or social media for outage notices.

We aim for high availability but no service is 100%.

What if I lose changes due to repeated sync failures

You shouldn’t — pending changes are persisted locally to disk and survive app restarts. Even after force-closing the app, pending changes resume syncing on next launch.

If you suspect changes were lost (e.g., a volume you scanned isn’t in your collection on another device), re-do the action and check for sync banner.