Fix a sync problem

Outcome: You will identify whether the problem is in the source download, selection, Microsoft access, or page delivery.

Which message do you see?

If ReMarkSync already shows a message on the page, go straight to its guide:

Message in ReMarkSync	Where to read
Couldn’t upload this page with Retry this page	Retry one page
Get help is the main button	Get help for a page
Waiting its turn to sync, Appearing soon, Waiting for OneNote, Sync is paused	Why a page is waiting
Sync paused after repeated errors	Why a page is waiting
Allow OneNote access, Admin approval needed, or another OneNote access message	OneNote access problems
Any other button on the page	Recover and retry a page

If there is no message, check the sync path below.

Before you begin

• Keep ReMarkSync open.
• Know the name of one missing document or page.
• Do not repeatedly retry an item if OneNote may already contain it.

Check the sync path

1. Open the official reMarkable desktop app.
2. Confirm the latest edit is visible there. If it is not, wait for the official app to finish syncing.
3. In ReMarkSync, open Library.
4. Search for the page and confirm it is selected.
5. Open Dashboard and read the latest-sync result separately from the current page-status counts. If there is no active sync or recovery to wait for, use Sync now to check for new changes. It does not bypass a protected recovery state.
6. Open Activity, select Open now, and search for the page name. Use Latest sync when you are checking only the most recent session.
7. If the page shows a OneNote access message, follow OneNote access problems.
8. If the page says No action needed, ReMarkSync is handling it. See Why a page is waiting.
9. If the page has a button, read its message first, then use Recover and retry a page to choose. A visual check in OneNote alone cannot prove that a page is absent.

Common symptoms

Latest sync completed, but older pages still need attention

The latest-sync result reports only the pages in that session. Select the current attention count to open the exact pages in Activity > Open now. Do not subtract those obligations from a completed latest-sync total unless Activity links them to that session.

A status count opens an empty list

The page may have resolved or changed state after the count was displayed. Select Refresh, confirm Open now and the active status, then select Clear filter if another restriction is still applied. An empty result does not require a retry.

The change is not in the reMarkable desktop app

ReMarkSync cannot see it yet. Keep the official app running and connected until the change reaches the computer.

The page appears in Library as Not selected

Turn the page, notebook, PDF, or parent folder on, then select Sync selected.

Microsoft sign-in or permission expired

Follow the ReMarkSync action to reconnect or allow OneNote access. Your queued pages stay local while ReMarkSync waits. See OneNote access problems.

The page failed after OneNote may have accepted it

Use the verification or recovery action ReMarkSync offers. It checks the original outcome before permitting a replacement. If an eligible recovery copy is offered, read its confirmation and destination carefully; a PDF recovery copy has visible but non-editable annotations. See Recover and retry a page.

The page changed while OneNote was saving it

Usually nothing is needed: one more normal update brings the newest version. In rare cases the page reads Finishing an earlier upload safely; wait for Latest page recovered. See when a page changes during upload.

Protected page needs support after the source was removed

ReMarkSync paused deletion because a possible OneNote page remains unresolved. No automatic check scheduled means repeated processing stopped; it does not mean the item completed. Click Get help on the page and follow its steps. Restoring the source or selecting Sync now does not authorize another upload. See the protected-source procedure.

An old error remains after the page completed

History keeps earlier events for context. Check Open now and the page’s current facts to decide whether any follow-up remains. A historical error does not make a verified completed page unresolved again.

A new page or notebook was not selected automatically

Check the item’s controlling Auto rule and any explicit exclusion. Older unchecked items remain unchecked after Auto is enabled, and PDFs stay manual. Follow automatic inclusion troubleshooting.

An older reMarkable page cannot be read

ReMarkSync supports v5 and v6 page formats automatically. Wait for the local file to finish downloading. A damaged or unsupported page can still fail individually; repeating an unchanged parse failure will not repair its content. See format compatibility.

An update is ready but never installs

On macOS, ReMarkSync installs an update only when no page is syncing right now. While it waits, the banner can say “The update is ready. Some pages are still syncing.” or “Finishing one last OneNote step. Nothing will be interrupted.” Pages that are stuck no longer block the update. If an older version keeps waiting because of stuck pages, download ReMarkSync once and install it over the current version. Your settings and sync history stay. Later updates install normally.

Gather diagnostics for support

For a problem on one page, the quickest route is Get help on that page. It saves the file and prepares the email for you. See Get help for a page.

1. In Activity, select Diagnostics.

Diagnostics sits in the Activity toolbar. Diagnostics use sanitized paths by default and remain on your computer until you choose to export and send them. Example using synthetic data.Open full size

2. Keep Include names and paths off unless support specifically asks for that information and you have reviewed it.
3. Select Export diagnostics only when you intend to attach the file to a support request.

Expected result

Expected result

You can name the failed stage and either restore syncing or provide support with a privacy-reviewed diagnostic export.

If your screen looks different

Recovery controls appear only for problems ReMarkSync can handle safely. If no retry is offered, use the error detail and contact support instead of forcing repeated attempts.

Troubleshooting

If the same failure continues after these checks, use Get help on the page, or email support@remarksync.com with the ReMarkSync version, platform, approximate time, and the exact visible message. Attach diagnostics only if you choose to share them.

Next stepContact supportEmail support if the same failure continues after these checks.