Calibre E-Book Viewer Highlights Not Saving: How to Fix It

When calibre E-book viewer highlights are not saving, the failure usually belongs to one of four categories: the annotation was created in a different copy or format of the book, calibre cannot write to the library, the desktop viewer and Content server are not configured to sync, or another program is interfering with the library files. The safest way to troubleshoot the problem is to create one controlled highlight, identify exactly where it should be stored, and change only one variable at a time. The steps below cover Windows, macOS, and Linux without requiring developer knowledge.

1. Confirm the Symptom With a Small Safe Test

Before changing permissions, reinstalling calibre, or repairing the library, determine whether highlights fail everywhere or only in one book. A controlled test can separate a damaged e-book from a library-wide problem in a few minutes.

1.1 Test One Known-Good EPUB

Use a normal, non-DRM EPUB that you are legally permitted to open and modify. EPUB is the best test format because calibre can store viewer annotations centrally in its library and, by default, can also store them inside the EPUB file. Avoid beginning with PDF, MOBI, AZW, a book opened from an email attachment, or a file accessed directly from removable storage.

1. Add the test EPUB to the calibre library through the main calibre window.
2. Select its library record and click View.
3. Highlight a short sentence and add a distinctive note such as calibre save test.
4. Open the viewer's Highlights panel and confirm that the new highlight appears.
5. Close the viewer normally, wait several seconds, and open the same library record again.
6. Check both the page and the Highlights panel.

Success means the highlight remains visible after the viewer is closed and reopened. If it does, stop changing global settings. The original book, format, location, or workflow is the likely cause. If the test highlight disappears, continue with the library and permission checks.

1.2 Verify That You Reopened the Same Book and Format

A calibre book record can contain EPUB, PDF, MOBI, and other formats at the same time. Annotations are associated with a particular book record and format. A highlight created while reading the EPUB should not be expected to appear automatically when the PDF edition is opened.

Right-click the View button and choose the exact format you tested. Also confirm that you are viewing the book from the Library section rather than the Device section. Viewing a device copy can open a physically different file even when its title and cover look identical.

Success means reopening the exact format from the same library record restores the annotation. If that works, no repair is needed. Use that same record and format consistently.

2. Check Where Calibre Stores Viewer Annotations

Understanding annotation storage prevents many false alarms. Calibre's desktop viewer can keep highlights in the calibre library's central annotation data. For EPUB books, highlights can also be written into the EPUB file itself. These storage methods support calibre's viewer, but they do not guarantee that every external reading application or hardware device will display the same annotations.

2.1 Look in Browse Annotations

Close the viewer, return to the main calibre window, right-click View, and choose Browse annotations. Search for the test note or filter the results to the test book.

• If the annotation appears here but not on the page, the library saved it and the problem is probably format selection, book identity, or viewer display behavior.
• If it appears on the page but not in Browse annotations, verify that you opened the book from a registered calibre library record.
• If it appears nowhere after reopening, investigate write permissions, cloud synchronization, or configuration problems.

Success means the test annotation appears both in the book's Highlights panel and in the library-wide annotation browser. Once both locations agree, stop changing library settings.

2.2 Do Not Assume Device Highlights Sync Automatically

Sending an EPUB to a Kindle, Kobo, tablet, phone, or other reader usually creates a separate copy. Highlights made later in the device's reading application are controlled by that device and application. They are not automatically the same as highlights created in calibre's desktop E-book viewer.

Calibre has device-specific annotation features, including an experimental Fetch Annotations action for supported workflows, but device support varies. Imported device annotations may be placed in book metadata rather than merged into the desktop viewer's highlight layer. A plugin may provide a separate import workflow, but its behavior should not be confused with native viewer annotation saving.

Success means desktop highlights survive in the desktop viewer. Treat device annotation transfer as a separate feature and test it independently with one book.

2.3 Configure Content Server Annotation Sync Deliberately

The browser-based Content server viewer and the desktop E-book viewer can sync annotations, but the desktop viewer must know which Content server user to sync with. Open the desktop viewer preferences, go to Miscellaneous, and enter the username used by the Content server viewer. If the server viewer is being used anonymously, calibre documents a special anonymous-user value for this setting.

Use the same authenticated server account on each browser or device. If a browser viewer does not show the latest reading state, open its controls and use its Sync command. Keep in mind that browser storage, server access, authentication, and the desktop library are separate parts of this workflow.

Success means a new test highlight created under the intended server user becomes available through the configured sync relationship. Once that occurs, do not keep changing server permissions or usernames.

3. Check Library State, File Support, and Viewer Behavior

3.1 Make Sure the Library Is Writable

Calibre needs write access to its library database and book directories. A library may be readable while writes fail because it was copied from another account, restored from read-only media, placed in a protected system directory, or assigned restrictive ownership.

Locate the active library by using Switch/create library and noting the current path. Then check the folder with your operating system:

• Windows: Open the folder's Properties, clear an inappropriate read-only restriction where applicable, and verify that your Windows account has Modify and Write permissions under Security.
• macOS: Open Get Info, inspect Sharing and Permissions, and confirm that your account has Read and Write access. Also check whether macOS privacy controls are blocking access to Documents, removable volumes, or network locations.
• Linux: Confirm that your user owns the library or has write permission for the library folder, its book subfolders, and its database files. Avoid launching calibre alternately as root and as a normal user.

Do not change permissions across unrelated folders. Test the known-good EPUB immediately after correcting the library folder. Success means its new highlight remains after restarting calibre.

3.2 Open the Library Copy Instead of an External Source File

If you launch an EPUB by double-clicking it in a download folder, email attachment cache, temporary folder, USB drive, or file manager, the viewer may be working with a standalone file rather than the copy managed by your calibre library. Temporary and attachment locations may also be cleaned automatically.

Add the file to calibre, locate the new library record, and open it from the main calibre interface. Do not overwrite the library's book files manually in the file manager. If you need to replace or add a format, use calibre's book-management actions.

Success means the annotation survives when the book is always opened from its library record. At that point, remove duplicate shortcuts or external copies that make it easy to open the wrong file.

3.3 Test the Book's Format and Internal Structure

Highlights depend on identifiable text locations. EPUB generally provides the most predictable test, while fixed-layout documents, image-only pages, malformed HTML, frequently changing conversions, and some PDF content can produce different behavior.

If only one book fails, convert a legally accessible source to a fresh EPUB or use calibre's Edit book tools to check the EPUB for structural errors. Preserve the original format before experimenting. Do not repeatedly replace the format in the same record while testing because a changed document structure may no longer match existing highlight locations.

Success means a fresh, known-good EPUB in the same library preserves annotations. That result points to the original file's structure rather than a broken calibre installation.

3.4 Avoid Replacing the Book After Highlighting It

Metadata editing is not normally the same as replacing the book's content. However, reconverting a book, deleting and re-adding its format, downloading a different edition, or allowing a plugin to replace the file can alter the document structure. Existing highlights may then point to text locations that no longer exist.

For troubleshooting, disable automatic format replacement and avoid reconversion. Create a highlight, close the viewer, and reopen the book without running any other operation. If it saves, introduce your normal conversion, metadata, or plugin actions one at a time until the responsible step becomes clear.

4. Remove Operating System and Storage Interference

4.1 Move the Test Library Out of Cloud-Synced Storage

OneDrive, Dropbox, iCloud Drive, Google Drive, Syncthing, backup agents, and similar tools may lock, delay, replace, or create conflicting versions of files while calibre is writing. Calibre's guidance is that a file-syncing tool and calibre should not access the library simultaneously.

Pause synchronization completely and repeat the test. For a stronger test, create a small temporary library in a normal local folder that is not synchronized, indexed by an unusual third-party tool, or stored on demand. Add only the known-good EPUB.

If highlights save in the local library, keep the working library local while calibre is open. A backup tool can copy the library only after calibre is fully closed. Do not allow two computers to open and modify the same synced library at the same time.

4.2 Avoid Network Shares and NAS Libraries

Calibre libraries rely on filesystem behavior such as dependable locking. Network shares and NAS filesystems may not provide the required behavior consistently, even when ordinary file copying works. Move the test library to the computer's internal drive and retest there.

Use the Content server when you need network access to books. It is safer than directly opening one library database from multiple computers. Success means local highlights persist and remote reading is handled through the server rather than a shared library folder.

4.3 Check Antivirus and Ransomware Protection

Security software can permit calibre to read books while blocking changes to protected folders. Review recent block events for calibre and its E-book viewer. On Windows, pay particular attention to controlled folder access if the library is under Documents. On macOS, inspect privacy permissions. On Linux, check sandboxing or mandatory access controls if calibre was installed through a restricted package system.

Do not disable protection permanently. If testing shows that security software is responsible, create the narrowest appropriate permission for calibre and its library folder. Success means a newly created annotation remains after both the viewer and main application are restarted.

4.4 Do Not Edit a USB Device Copy Directly

A connected reader may expose books through USB mass storage, a media-transfer protocol, or a vendor-specific interface. Write behavior can differ from a local disk, and the reader may rebuild its own database after disconnection. Copy or add the test book to the calibre library and test the desktop viewer against the library copy.

Eject devices through calibre or the operating system after transfers. If the computer test works but the device loses annotations, the problem belongs to the device's reading application or annotation database, not calibre's desktop viewer.

5. Use Logs and Isolation Tests When the Cause Is Still Unclear

5.1 Restart Calibre in Debug Mode

From the main calibre interface, use the option to restart in debug mode. Reproduce the failure with one highlight, close the viewer, reopen the book, and then exit calibre so the debug output can be reviewed. Look for permission errors, database write failures, missing paths, plugin exceptions, or messages associated with the viewer.

Do not assume every warning is relevant. The useful event is one that occurs at the moment the annotation is created, the viewer closes, or the book reopens. Save the log before making additional changes.

5.2 Launch the Viewer With Calibre-Debug

Advanced users can run the viewer from a terminal with calibre-debug -w "/path/to/test.epub". This can expose errors that are otherwise hidden. A standalone file test is useful for viewer behavior, but it does not test whether calibre can write central annotations to a particular library record.

Compare the result with opening the same EPUB through the main library. If the standalone viewer behaves correctly but the library workflow fails, focus on the active library path, database access, and book identity.

5.3 Disable Third-Party Plugins Temporarily

A plugin that imports annotations, replaces formats, modifies metadata, or changes device behavior may affect the workflow even if the viewer itself is functioning. Record which plugins are enabled, then temporarily disable only those related to annotations, formats, devices, or automated library changes.

Restart calibre and repeat the controlled EPUB test. If saving begins to work, re-enable plugins one at a time. Stop as soon as the failure returns, then consult that plugin's support resources rather than changing unrelated calibre settings.

5.4 Check the Library Without Immediately Restoring It

Use Library maintenance to check the library for consistency problems. A check is safer than immediately rebuilding the database. Database restoration is a recovery operation, not a routine annotation fix, and it can discard some database-only information.

Back up the entire library folder before performing destructive maintenance. Restore the database only when there is evidence of database corruption and after safer tests have failed. If the library opens normally and a temporary library saves annotations, migrating books to a healthy library may be safer than repeatedly repairing the original.

6. Run a Clean Temporary Test Before Reinstalling

Reinstalling calibre usually does not repair unwritable library folders, cloud conflicts, damaged source books, or confused Content server identities. A temporary clean test provides more useful evidence.

1. Close calibre and pause cloud synchronization.
2. Create a new local folder named something like Calibre Annotation Test.
3. Use Switch/create library to create a new empty library there.
4. Add one known-good EPUB.
5. Create one highlight and one note.
6. Close the viewer, restart calibre, and reopen the same EPUB record.
7. Check the page, Highlights panel, and Browse annotations window.

If this works, the calibre installation and viewer are fundamentally capable of saving highlights. The cause is in the original library, book, configuration, plugin set, or storage environment. Stop considering a reinstall and compare those elements individually.

If it fails in the clean local library, repeat the test with plugins disabled and review debug output. Updating calibre through its official installer may also resolve a known viewer defect, but preserve the original library and configuration until you have confirmed the result. Do not delete your main library as a troubleshooting shortcut.

7. Quick Fix Checklist

• Test one known-good, non-DRM EPUB added through calibre.
• Open the book from the Library view, not the Device view or file manager.
• Reopen the same book record and the same format.
• Check the viewer's Highlights panel and calibre's Browse annotations tool.
• Confirm that your user account can write to the entire library folder.
• Pause OneDrive, Dropbox, iCloud Drive, and other synchronization tools.
• Move the test library off a NAS, network share, USB device, or protected folder.
• Configure the Content server username in viewer preferences if browser sync is expected.
• Do not expect desktop highlights to appear automatically in unrelated device applications.
• Avoid replacing, reconverting, or re-adding the book during the test.
• Temporarily disable annotation, format, metadata, and device plugins.
• Use debug mode and note errors produced when closing the viewer.
• Test a new local library before reinstalling or repairing the database.

8. Frequently Asked Questions

8.1 Where Does Calibre Store Highlights and Annotations?

Calibre stores viewer annotations centrally in the calibre library so they can be browsed across books. For EPUB books, annotations can also be stored inside the EPUB file. The annotation is still associated with a particular book record, format, and viewer identity, so another copy or format may not display it.

8.2 Why Do Highlights Disappear After I Convert the Book?

Conversion can restructure chapters, paragraphs, and internal files. A highlight created against the old structure may not map cleanly to the converted edition. Finish conversion before beginning serious annotation, or retain the original annotated format without replacing it.

8.3 Will Calibre Highlights Sync to My E-Reader?

Not automatically in every case. A device normally has its own book copy, annotation database, and reading software. Calibre's device annotation features and third-party plugins have device-specific limitations. First prove that desktop viewer annotations save correctly, then test the device workflow separately with one disposable highlight.

8.4 Can I Keep My Calibre Library in OneDrive or Dropbox?

A synchronized copy can be useful for backup, but simultaneous access is risky. Calibre and the syncing application should not write to the library at the same time, and multiple computers should not modify the same synced library concurrently. For troubleshooting, move the library to an unsynchronized local folder.

8.5 Should I Restore the Calibre Database?

Only when checks or logs indicate database corruption. Restoration is not the first fix for disappearing highlights. Start with a known-good EPUB, confirm permissions, stop cloud synchronization, disable relevant plugins, and test a new local library. Back up the complete library before any database recovery.

8.6 How Do I Know the Problem Is Fixed?

Create a new highlight with a unique note, close the viewer normally, restart calibre, and reopen the same format from the same library record. The highlight should appear on the page, in the book's Highlights panel, and in Browse annotations. If all three checks succeed twice, stop changing settings and return to normal use.