calibre Edit Book TOC Editor Not Saving: How to Fix It

You edit chapter names, rearrange entries, or repair links in calibre's Edit book Table of Contents editor, but the finished EPUB or AZW3 still shows the old Table of Contents. In most cases, the edits are not truly lost. The usual causes are an incomplete save sequence, confusion between the navigation Table of Contents and an inline contents page, reopening or transferring the wrong format, a viewer displaying an already loaded copy, or a later conversion rebuilding the Table of Contents. The steps below isolate these possibilities without requiring you to reinstall calibre, delete your library, or make risky bulk changes.

1. Confirm the Symptom With a Small Safe Test

Before changing settings, make one unmistakable edit and trace it from the editor to the final file. This establishes whether calibre failed to save the edit or whether another program is displaying a different copy.

1.1 Verify that you are editing the intended format

A calibre library record can contain several formats, such as EPUB, AZW3, MOBI, and PDF. Editing the EPUB does not automatically apply the same structural edit to the AZW3 or any other format stored under that title.

1. Select the book in the main calibre window.
2. Look at the available formats in the book details panel or open Edit metadata and inspect the formats list.
3. Open Edit book and confirm the format shown in the editor's title bar.
4. If calibre asks you to choose a format, select the exact EPUB or AZW3 you intend to test.

For the first test, avoid opening a file from an old export folder, email attachment, device, or cloud directory. Start from the library record so there is no ambiguity about which copy you are changing.

1.2 Make one obvious Table of Contents change

In Edit book, choose Tools, Table of Contents, and Edit Table of Contents. Change one entry to a distinctive temporary label such as “TEST Chapter One.” Do not change several entries yet.

Confirm or accept the change in the Table of Contents dialog. Then use File, Save in the main Edit book window. Closing only the Table of Contents dialog is not the same as saving the modified EPUB or AZW3 to storage.

Success looks like this: after closing and reopening Edit book from the same library record, the navigation Table of Contents still contains “TEST Chapter One.” If it does, stop changing editor settings. The edit was saved, and the problem is farther downstream, such as the viewer, conversion, export, or device copy.

1.3 Check the editor's own Table of Contents view

Open View, Table of Contents inside Edit book. Refresh that panel if necessary and inspect the changed entry. Double-click it to confirm that it opens the correct chapter location.

If the changed label appears and its target works, the editor's internal navigation structure has been updated. If the label appears but points to the wrong place, reopen the Table of Contents editor and use the location control to select the correct heading or paragraph.

2. Distinguish the Navigation TOC From the Inline Contents Page

The most common misunderstanding behind a calibre Edit book TOC editor not saving report is that an e-book may contain two separate things that look like a Table of Contents.

2.1 The metadata or navigation Table of Contents

The navigation Table of Contents is used by the reader application's TOC button, navigation panel, or chapter menu. In an EPUB, this structure is normally represented by a navigation document, an NCX file, or both, depending on the EPUB's construction. calibre's Edit Table of Contents tool modifies this navigational structure.

This tool does not necessarily rewrite a visible HTML page titled “Contents” inside the book. Therefore, opening the first few pages and seeing old chapter names does not prove that the navigation edit failed.

2.2 The inline content Table of Contents

An inline Table of Contents is an ordinary page within the book's reading flow. It may be named contents.xhtml, toc.xhtml, index.html, or something else. Its links and text can remain unchanged even after the navigation Table of Contents is repaired.

To determine which one you are viewing:

• If it appears when you press the viewer's Table of Contents or navigation button, it is the navigation TOC.
• If you reach it by turning pages or clicking a “Contents” link in the book, it is probably an inline HTML page.
• If changing the navigation TOC has no effect on the visible contents page, the two structures are separate.

If you want the visible page to match the navigation structure, use Tools, Table of Contents, Insert inline Table of Contents. calibre generates that page from the currently defined navigation TOC. If an inline TOC previously created by this tool exists, running the tool again can replace it.

Alternatively, open the existing contents HTML file and edit its text and links manually. Do this only if you intentionally want to preserve the publisher's layout.

Success looks like this: the reader's navigation panel shows the corrected entries, and, if required, the visible contents page also shows them. Once both are correct, do not regenerate either TOC again.

3. Save the TOC Into the Actual EPUB or AZW3

3.1 Complete both stages of the save process

Use this sequence consistently:

1. Open Tools, Table of Contents, Edit Table of Contents.
2. Make the required entry, hierarchy, or destination changes.
3. Confirm the Table of Contents dialog.
4. Return to the main Edit book window.
5. Select File, Save or click the Save button.
6. Wait for saving to finish before closing the editor.

If you close the main editor while it still considers the book modified, respond carefully to any save prompt. Discarding changes at that point reverses the TOC work.

3.2 Reopen the book before exporting or converting

Close Edit book, reopen the same format from the same calibre record, and inspect View, Table of Contents. This is the simplest persistence test.

If the edit survives reopening, the library copy is good. Stop troubleshooting permissions and editor saving. Move to viewer, conversion, or transfer checks instead.

If it does not survive reopening, use File, Save a copy immediately after making the test edit. Save the copy to a normal local folder, such as Documents, rather than directly to removable media or a synchronized folder. Open that saved copy in calibre's viewer and inspect its navigation panel.

• If the saved copy is correct, the editor can build a valid file, but updating the library copy may be encountering a storage or library-state problem.
• If the saved copy is also wrong, repeat the edit and ensure the Table of Contents dialog was confirmed before the main editor was saved.

3.3 Check the navigation file inside the editor

For an EPUB, inspect the file browser for the navigation document or NCX file identified by calibre as the Table of Contents. EPUB 3 books commonly use a navigation document, while EPUB 2 books commonly use an NCX structure. Some books contain both for compatibility.

You do not need to edit XML manually. Instead, use the dedicated TOC editor and then run Tools, Check book. Pay particular attention to broken links, missing files, invalid anchors, malformed markup, and package-document errors.

Success looks like this: Check book no longer reports TOC-related broken destinations, and double-clicking each important entry in View, Table of Contents opens the intended location. Stop once those tests pass.

4. Eliminate Viewer and File-Copy Confusion

4.1 Reload or reopen the calibre viewer

A viewer window that was already open may still be presenting the book state it loaded earlier. After saving the editor changes, close the old viewer window and reopen the book from the calibre library. You can also use the viewer's Reload book command.

Open the viewer's navigation panel rather than relying only on a visible contents page. If the edited label appears there, the TOC save worked.

4.2 Confirm which format the viewer opened

If a record contains EPUB and AZW3, calibre may open a format other than the one you just edited, depending on your format selection and viewer preferences. Explicitly choose the edited format when testing.

A dependable method is to save the edited format to a temporary folder with Save to disk, then open that exact file directly in the calibre viewer. Give it a recognizable filename such as toc-test.epub.

Success looks like this: the temporary file shows the corrected navigation entry. At that point, the book itself is fixed. Any remaining mismatch comes from an older exported, emailed, served, or device-resident copy.

4.3 Replace the copy on the reading device

Saving an EPUB or AZW3 in the calibre library does not modify a copy that was previously sent to a device. Delete or replace the old device copy using the normal supported transfer method, then reopen it on the device.

Some reading systems import books into their own storage rather than reading the source file in place. Copying a new file beside the old one may create a duplicate or leave the imported edition untouched. Confirm the displayed filename, format, title, and modification time where the device exposes that information.

If calibre's viewer shows the correct navigation but the device does not, stop changing the book until you have verified that the device received the newly saved file. The device's TOC support or import cache is now the likely variable.

5. Prevent Conversion From Overwriting the Edited TOC

A correct TOC can appear to revert when the edited book is converted again. Conversion creates a new output and may use the input TOC, generate entries from detected headings, or apply previously saved conversion settings.

5.1 Edit after the final conversion

The safest workflow is:

1. Convert the source into the final EPUB or AZW3 format.
2. Open that final format in Edit book.
3. Repair the navigation TOC.
4. Save the book.
5. Test that exact format in the calibre viewer.
6. Send or export it without reconverting it.

If you edit an EPUB and then convert the original DOCX, PDF, or older e-book format into EPUB again, the newly generated EPUB can replace the corrected one.

5.2 Review Table of Contents conversion options

Open the conversion dialog and inspect the Table of Contents section. Options that force an automatically generated TOC, detect chapters, filter entries, or create entries from links can produce a structure different from your hand-edited version.

If manual control is the goal, avoid forcing an auto-generated TOC after you have finished editing. calibre can also launch its TOC editor after conversion through the manual fine-tuning option. That is useful when conversion must occur, but the manual corrections should still be the final structural step.

5.3 Check job details after an unexpected result

When conversion creates the wrong TOC, open the completed job's details in calibre. Look for the input format, output format, chapter detection activity, TOC generation messages, and warnings about malformed source content.

For command-line conversions, inspect the options passed to ebook-convert. An XPath rule, forced generation option, TOC filter, or inline-TOC option can change the result even when the source EPUB previously had the desired navigation.

Success looks like this: the converted output has the expected TOC before any manual repair, or the manually repaired final output remains unchanged because it is no longer converted. Stop adjusting conversion options once one repeatable workflow produces the correct final file.

6. Check Storage, Library, and Source-File Problems

6.1 Test a local writable folder

Permissions are relevant when the TOC disappears after the editor reports a save error, the file's modification time does not change, or Save a copy fails. Test saving a copy to a local folder owned by your user account.

• On Windows, avoid protected application folders and test under Documents.
• On macOS, check whether calibre has been denied access to the selected folder under Privacy and Security settings.
• On Linux, verify that your account can create and replace files in the destination directory.

Do not run calibre as an administrator or root as a routine workaround. Correct the folder ownership or choose a normal user-writable location.

6.2 Pause cloud synchronization during the test

If the calibre library is inside a live synchronization folder, another process may lock, delay, restore, or conflict with files while calibre is saving. For diagnosis, create a small temporary local library outside OneDrive, Dropbox, iCloud Drive, network shares, and similar synchronization locations.

Import only the test EPUB or AZW3, make the TOC edit, save, close the editor, and reopen the book. If the edit persists locally but not in the synchronized library, the storage arrangement is the relevant difference.

6.3 Avoid editing directly on removable or network storage

Do not use a device-mounted copy as the primary editing target. USB disconnections, media access modes, network interruptions, and reader-managed storage can interfere with replacement operations. Edit the library copy on local storage, verify it, and transfer the finished file afterward.

6.4 Inspect source quality with Check book

A damaged package, duplicate navigation structure, broken anchors, or malformed content can lead to inconsistent results across readers. In Edit book, create a checkpoint and run Tools, Check book. Fix errors directly connected to navigation, manifests, spine entries, missing files, or broken links.

Use automatic fixes selectively. Recheck the book after each meaningful repair and verify the TOC in the calibre viewer. Once navigation works, avoid unrelated cleanup that could introduce new differences.

7. Use Focused Diagnostics When the Basic Fixes Fail

7.1 Preserve a known test file

Use Save a copy to create a standalone test EPUB or AZW3 immediately after the TOC edit. Record where it was saved and open that exact pathname in the viewer. This removes library selection, device transfer, Content server, and email delivery from the test.

If this standalone file is correct, the Edit book TOC editor is working. Investigate only the later step that delivers or transforms the file.

7.2 Compare before and after files

Create a copy before the edit and another after the edit. calibre's comparison tools can help show whether the navigation document or NCX changed. A structural difference confirms that the editor wrote the TOC update even if another reader does not display it as expected.

7.3 Use conversion debug output only for conversion failures

If the TOC becomes wrong during conversion, conversion debug output can preserve intermediate stages of the conversion pipeline. It is not normally needed for a direct Edit book save problem.

For command-line testing, ebook-convert supports verbose output and a debug pipeline directory. Compare the processed input and final output to identify when the TOC changes. Use a copied test file, not your only library copy.

7.4 Test without third-party plugins

A normal Edit book TOC save does not usually depend on plugins. However, a plugin that modifies formats, runs polishing operations, changes files during import or export, or supplies a separate sending workflow could replace the result later.

Temporarily disable only plugins involved in the affected workflow, then repeat the one-entry test. Do not remove unrelated device, metadata, or interface plugins without evidence.

Success looks like this: the edit persists when the relevant plugin is inactive. Re-enable plugins one at a time to identify the exact conflict.

7.5 Use calibre-debug for reproducible application errors

If Edit book displays an exception, closes unexpectedly, or reports that saving failed, launch calibre in debug mode and reproduce only the failing steps. Save the debug output when calibre closes. The useful evidence is the exact error, file path, format, and operation that triggered it.

Debug output is less useful when the file saves correctly but an old device copy is being viewed. Complete the standalone-file test first.

8. Run a Clean Temporary Test Before Reinstalling

Reinstalling calibre rarely repairs one book's navigation structure. First determine whether the problem follows the book, the library, or the application configuration.

1. Create a new temporary calibre library in a local, writable folder.
2. Add a copy of one DRM-free EPUB or AZW3 that you are authorized to edit.
3. Open it with Edit book.
4. Rename one navigation entry.
5. Confirm the TOC dialog and save the main editor.
6. Close Edit book completely.
7. Reopen the same book and inspect View, Table of Contents.
8. Open the same format in the calibre viewer and reload it.

If the test works, calibre's core editor is functioning. Return to the original book and investigate its structure, the selected format, conversion history, library location, or downstream delivery process.

If multiple unrelated books fail in the temporary local library, repeat the test with third-party plugins disabled and collect debug output. Only then consider resetting configuration or reinstalling. Back up the library and settings before any broad change.

9. Quick Fix Checklist

• Confirm that Edit book opened the intended EPUB or AZW3 format.
• Change one TOC entry to a unique test label.
• Confirm the TOC dialog, then use File, Save in the main editor.
• Close and reopen Edit book to verify persistence.
• Check View, Table of Contents and test the entry's destination.
• Distinguish the navigation TOC from a visible inline contents page.
• Regenerate or manually update the inline TOC only if needed.
• Run Check book and repair broken TOC targets or package errors.
• Close or reload the calibre viewer and open the edited format explicitly.
• Save a standalone copy and test that exact file.
• Avoid reconverting the final edited format.
• Replace the old copy on the device, server, email attachment, or export folder.
• Test from a local writable folder outside cloud synchronization.
• Disable only plugins involved in post-edit processing.
• Use debug output when there is an actual save or application error.

10. Frequently Asked Questions

10.1 Why does the TOC editor show my changes while the book's Contents page does not?

The TOC editor changes the book's navigation structure. A visible Contents page is usually a separate HTML document. Regenerate the inline Table of Contents from the corrected navigation TOC or edit the existing contents page separately.

10.2 Do I need to save after closing the Table of Contents editor?

Yes. Confirm the Table of Contents dialog, then use File, Save in the main Edit book window. Reopen the book afterward to prove that the modification was written into the EPUB or AZW3.

10.3 Why does the old TOC still appear in the calibre viewer?

The viewer may already have the book open, or it may be opening another format from the same library record. Reload or close the viewer, reopen the edited format explicitly, and inspect the viewer's navigation panel rather than only the inline contents page.

10.4 Can conversion undo manual TOC edits?

Yes. A later conversion produces new output and can reuse, regenerate, filter, or replace TOC entries according to its input and conversion settings. Convert first and perform final TOC editing afterward whenever possible.

10.5 Why is the corrected TOC visible on my computer but not my e-reader?

The device may still contain an older transferred or imported copy, or its reader software may interpret the navigation structure differently. Confirm that the standalone edited file works in calibre's viewer, then remove or replace the old device copy through the supported transfer workflow.

10.6 Should I reinstall calibre or delete my library?

Not as a first step. Test one copied book in a temporary local library and save a standalone file. If that succeeds, reinstalling will not address the actual cause. Never delete the main library as a TOC troubleshooting shortcut.