Calibre AZW3 Conversion Not Working: How to Fix It

  • Separate AZW3 conversion failures from Kindle transfer and device problems.
  • Test a clean EPUB before changing global calibre settings.
  • Use logs, viewer checks, and temporary libraries to isolate faults.

When calibre AZW3 conversion is not working, the failure usually falls into one of four categories: the conversion job fails, the resulting book opens but looks wrong, the file works in calibre but not on a Kindle, or the book reaches the Kindle with missing navigation, metadata, or cover art. These symptoms require different fixes. The fastest approach is to separate conversion problems from transfer and device problems, test with a known-good EPUB, and change one setting at a time.

AZW3 is a modern Kindle-oriented format with stronger layout and table of contents support than old-style MOBI. It is often a good choice for transferring personal books directly to compatible Kindle e-readers over USB. However, successful conversion does not guarantee that every Kindle app, delivery route, or device will handle the file identically. Source quality also matters. A clean EPUB normally converts more predictably than a PDF, scanned document, damaged HTML file, or poorly structured word-processing export.

Ebook conversion workflow from a clean source file to an e-reader, with success and failure paths.

1. Confirm the Symptom With a Small Safe Test

Before changing calibre preferences, identify exactly where the workflow breaks. Use one short, non-protected EPUB that you are legally allowed to convert. Avoid testing first with a large textbook, image-heavy document, scanned PDF, or book obtained from a retailer with access controls.

1.1 Run a controlled EPUB-to-AZW3 conversion

  1. Select the test EPUB in calibre.
  2. Click Convert books.
  3. Confirm that the input format shown at the upper left is EPUB.
  4. Choose AZW3 as the output format at the upper right.
  5. Leave most conversion options at their defaults.
  6. Open Page setup and select an appropriate Kindle output profile, or use a generic e-ink profile if no exact match is available.
  7. Start the conversion and wait for the job counter to return to zero.

Success means the job completes without an error, AZW3 appears in the book's format list, and the output opens in the calibre E-book viewer. If this simple conversion works, calibre's AZW3 output system is functioning. Stop changing global conversion preferences and investigate the original source file or Kindle transfer path instead.

1.2 Classify the failure before proceeding

  • Job fails: The conversion ends with an error or produces no AZW3 format.
  • Viewer failure: The AZW3 exists but will not open in calibre's viewer.
  • Layout failure: The book opens, but paragraphs, images, fonts, chapters, or margins look wrong.
  • Device failure: The AZW3 works in calibre but does not appear or open on the Kindle.
  • Navigation failure: The book opens, but its table of contents, Page Flip behavior, or chapter navigation is incomplete.
  • Presentation failure: The title, author, series information, or cover is missing or incorrect.

This classification is important because reinstalling calibre will not repair a malformed source document, and repeated conversion changes will not fix a USB connection problem.

2. Check the Settings and Book Data That Affect AZW3

2.1 Verify the actual input and output formats

Do not assume that the visible filename or library title identifies the source correctly. Open the book's metadata window and check the listed formats. During conversion, verify the input format in the upper-left selector and AZW3 in the upper-right selector.

If calibre selects PDF when an EPUB copy is also available, switch the input to EPUB. PDF describes fixed pages rather than a clean reflowable book structure, so PDF-to-AZW3 conversion can produce broken paragraphs, repeated headers, incorrect reading order, and badly positioned images. Those results do not necessarily mean calibre is not working.

Success means the AZW3 is generated from the best available source and its text reflows normally when the viewer window is resized.

2.2 Understand AZW3 versus MOBI and EPUB

AZW3 supports richer Kindle formatting and a proper metadata table of contents. MOBI is an older format with more limited layout behavior, although it may still be useful for older devices or specific software. EPUB is widely used as an editable and convertible source format, but Kindle handling depends on how the file is transferred.

For a compatible Kindle e-reader connected directly to calibre, converting a clean EPUB to AZW3 and using Send to device is a sensible workflow. For Amazon's online Send to Kindle service, EPUB is an accepted upload format and is processed by Amazon. Do not treat email or cloud delivery as a test of whether calibre successfully created a valid local AZW3 file.

Success means you have matched the format to the destination: AZW3 for a compatible direct-transfer workflow, or an accepted source such as EPUB for Amazon's Send to Kindle service.

2.3 Choose an appropriate output profile

Open the conversion dialog and select Page setup. For AZW3 output intended for Kindle hardware, choose a Kindle profile that reasonably matches the target device. An inappropriate profile can affect image scaling, screen dimensions, margins, and font rescaling.

Do not expect profile changes to repair missing chapters or scrambled source text. Profiles control presentation assumptions, not the underlying document structure. If the book already looks correct in the calibre viewer, avoid cycling through profiles without evidence of a device-specific layout problem.

Success means images fit the screen, margins are usable, and text size behaves normally on the intended Kindle.

2.4 Reset saved conversion options for the problem book

calibre can remember conversion settings for an individual title. This means an old experimental option may continue affecting later conversions even after you change a global preference. Open the conversion dialog for the problem book and use the option to restore defaults before converting again.

Pay particular attention to settings under Look and feel, Heuristic processing, Structure detection, Table of Contents, and AZW3 output. Disable aggressive transformations unless you know why they are needed. Heuristic processing can help badly formatted sources, but it can also misidentify headings or remove intentional breaks.

Success means a default conversion produces cleaner output than the previously saved configuration. Once that happens, stop enabling additional options.

2.5 Correct metadata and cover sources

Edit the title, author, author sort value, language, and cover before reconverting. If you downloaded metadata from the internet, confirm that it belongs to the exact edition. A mismatched identifier or edition can attach the wrong cover or title information.

After replacing a cover, reconvert the source to AZW3 so the new image is embedded in the output. Merely changing the library thumbnail does not always update an AZW3 file that was created earlier. Delete the old copy from the Kindle before sending the rebuilt version, because the device may otherwise continue displaying cached information.

Success means the converted book shows the intended metadata and cover in calibre before transfer. Kindle library cover behavior can still vary by device and firmware, so a correct book cover in the calibre viewer is the best initial confirmation that conversion succeeded.

2.6 Preserve table of contents behavior

A Kindle book may contain a visible contents page, a navigation table of contents used by reading software, or both. AZW3 supports a metadata table of contents, but Kindle features can also depend on the generated inline contents information. Avoid disabling table of contents generation simply because two contents views appear similar.

If chapters are missing, inspect the source EPUB first. Open it in calibre's editor or viewer and check whether its navigation panel already contains the correct chapter list. If the source has no usable headings or navigation structure, automatic AZW3 conversion has little reliable information from which to build one.

Success means the calibre viewer's table of contents panel lists the chapters in order and selecting an entry opens the correct location. Confirm the same behavior on the Kindle before making further changes.

3. Check the Kindle, Operating System, and Source File

3.1 Confirm that the destination supports the workflow

Kindle e-readers, Kindle applications, and Amazon's online document service are not interchangeable. A file that can be transferred directly to supported Kindle hardware may not be accepted as an email attachment or opened manually by a Kindle app. If the AZW3 works in calibre but fails in an app, test it on the actual Kindle e-reader for which it was created.

Use Send to device only after calibre detects the Kindle. This allows the device driver to choose the destination folder and apply device-related handling. Email delivery is a separate service with its own accepted input formats and should not be used to diagnose local AZW3 conversion.

3.2 Verify USB detection before blaming conversion

Connect only one reading device at a time. Use a data-capable USB cable, connect directly to the computer when possible, unlock the device, and wait briefly for detection. A charge-only cable can power the Kindle without exposing it to the operating system.

On Windows, confirm that the device appears in File Explorer when the Kindle model exposes normal storage. On macOS and Linux, device access can depend on the model and transfer method. Newer devices may use a different USB workflow, so follow the current Amazon and calibre guidance for that specific device.

In calibre, check Preferences, then Ignored devices, and make sure the Kindle was not accidentally ignored. If the operating system cannot see or access the device, calibre cannot reliably send a converted book to it.

Success means calibre displays the device controls and Send to device completes without an error. At that point, stop changing conversion settings unless the transferred book itself is malformed.

3.3 Check permissions, security tools, and cloud synchronization

Keep the active calibre library in a normal local folder where your user account has full read and write access. Avoid placing the live library inside a cloud-synchronized folder, removable drive, network share, or aggressively protected directory while troubleshooting. Synchronization software can lock or partially upload files while calibre is writing the new AZW3.

On macOS, review Files and Folders permissions if calibre cannot access the library or connected device. On Linux, confirm that the library and temporary directories are writable and that a mounted device is not read-only. On Windows, controlled folder access or antivirus software can block writes without clearly identifying the affected book.

Temporarily pausing synchronization is safer than deleting the library. If security software reports a block, add a narrowly scoped exception for calibre's official executable and library folder rather than disabling protection entirely.

Success means the same conversion completes repeatedly and the output file remains readable after calibre finishes writing it.

3.4 Judge the source file independently

Open the original source in calibre's viewer before converting it. Check several chapters, images, footnotes, and the table of contents. If text is already missing, out of order, or displayed as page images, the AZW3 output will inherit those limitations.

When possible, obtain or create a clean EPUB source and try EPUB-to-AZW3. For DOCX, use consistent heading styles and real paragraph breaks before importing it. For HTML, ensure linked images and style sheets are available. For PDF, expect that manual cleanup may be necessary, especially when the document has columns, headers, footers, scans, or complex positioning.

Success means the source is readable and structurally sound before conversion. Once a known-good EPUB converts properly, stop modifying calibre and repair or replace the original source.

Sequential ebook processing stages with one highlighted failure point and a diagnostic log.

4. Use Logs and Debug Output to Find the Exact Failure

4.1 Read the conversion job details

After a failed conversion, click the jobs indicator in calibre and open the failed job's details. Start near the bottom of the log, where the final error is usually reported, and then look upward for the first meaningful warning or exception.

Useful clues include an unreadable input file, a missing linked image, invalid markup, permission denial, insufficient temporary storage, or a plugin error. Do not focus only on the last technical line. The first failure often explains the later messages.

Success means you can connect the error to a specific input file, setting, directory, or plugin instead of applying unrelated fixes.

4.2 Generate conversion debug output

The conversion dialog includes a debug option that writes intermediate conversion stages to a folder. calibre can expose the input, parsed, structure, and processed forms of the book. These files help identify where formatting changes.

  • If the problem already exists in the input stage, the input plugin or source is responsible.
  • If it appears after parsing, inspect encoding and malformed markup.
  • If chapter boundaries change in the structure stage, review structure detection and table of contents settings.
  • If the processed content is correct but the AZW3 is not, the output stage deserves closer inspection.

This is an advanced diagnostic method, but it does not require programming. Open the generated HTML files in a browser and compare the same chapter between stages.

4.3 Debug device detection

If conversion succeeds but the Kindle is absent from calibre, connect the device and open Preferences, then Miscellaneous, then Debug device detection. Save the output if you need to report a reproducible detection problem.

Command-line users can also use calibre's debugging tools, including device-driver diagnostics and a GUI debug mode. These tools are most useful after the basic cable, operating-system detection, permissions, and ignored-device checks have passed.

4.4 Test without custom plugins

A file-type, metadata, interface, or device plugin can alter the workflow. If the problem began after installing or updating a plugin, disable that plugin temporarily and repeat the small EPUB-to-AZW3 test. Experienced users can launch calibre with custom plugins ignored.

Do not remove every plugin at once. Disable the most relevant one first, test, and record the result. Success means the conversion or transfer works with the suspected plugin disabled. Leave it disabled while checking for a compatible update or support guidance.

5. Run a Clean Temporary Test Before Reinstalling

Reinstalling calibre rarely repairs a single damaged book or a library stored in an unwritable location. Before reinstalling or deleting anything, isolate the problem with a temporary library.

  1. Create a new empty folder on a local drive.
  2. Use calibre's library switcher to create a temporary library there.
  3. Add one known-good, non-protected EPUB.
  4. Do not download metadata or enable special conversion options.
  5. Convert it to AZW3 using defaults and a suitable Kindle output profile.
  6. Open the AZW3 in calibre's viewer.
  7. If applicable, connect the Kindle and use Send to device.

If this works, the calibre installation is probably sound. The cause is more likely to be the original book, saved per-book options, library permissions, a plugin, or device-specific handling. Return to the normal library and compare one factor at a time.

If the clean test fails, save the job log and repeat with custom plugins disabled. Only consider reinstalling after a clean local library and known-good EPUB fail in the same way. Never delete the original library as a troubleshooting experiment. Back it up before performing repairs or migrations.

6. Quick Fix Checklist

  • Confirm that AZW3 is selected as the output, not merely the preferred format.
  • Try a known-good EPUB source before testing PDF or scanned content.
  • Open the new AZW3 in calibre's viewer before transferring it.
  • Reset saved conversion settings for the affected title.
  • Select an appropriate Kindle output profile under Page setup.
  • Check the source table of contents and chapter headings.
  • Recon­vert after changing metadata or the cover.
  • Delete the older device copy before sending the rebuilt file.
  • Use Send to device for direct Kindle transfer, not email as an AZW3 test.
  • Confirm that the operating system detects the Kindle and permits access.
  • Move the test library out of cloud-synchronized or network storage.
  • Read the failed job details before changing more options.
  • Test temporarily without the most relevant custom plugin.
  • Run a clean temporary-library test before reinstalling calibre.

7. Frequently Asked Questions

7.1 Why does the AZW3 work in calibre but not on my Kindle?

The device or transfer route may be the problem. Confirm that the target is a compatible Kindle e-reader, remove the previous copy, reconnect the Kindle, and use calibre's Send to device command. If calibre does not detect the device, troubleshoot USB access rather than reconverting repeatedly.

7.2 Should I convert EPUB or MOBI to AZW3?

Use the cleanest available source. EPUB is usually a practical source because it can contain reflowable text, styles, images, and structured navigation. A good MOBI can also convert, but an old or poorly generated MOBI may already have reduced formatting. Compare both sources in the viewer and choose the one with better structure.

7.3 Why is the table of contents missing or duplicated?

The source may contain both a visible contents page and a separate navigation table. That is not automatically an error. Check whether the viewer's navigation panel lists chapters correctly. Avoid disabling generated navigation unless you understand the effect on Kindle features. If entries are missing, repair the source headings or table of contents before reconverting.

7.4 Why does the Kindle show the wrong cover?

The AZW3 may contain an older embedded cover, the Kindle may have cached the previous book, or the device may handle sideloaded cover thumbnails differently. Update the cover in calibre, reconvert to AZW3, delete the old device copy, and send the new file again. If the correct cover appears inside the book and in calibre, the conversion itself has likely succeeded.

7.5 Can I email an AZW3 file to my Kindle?

Do not use email delivery as the main test of AZW3 conversion. Amazon's Send to Kindle service accepts specified source formats such as EPUB and processes them for supported devices and apps. For a locally created AZW3, direct device transfer is the clearer diagnostic path. This separates calibre conversion from Amazon's online intake rules.

7.6 When should I stop changing settings?

Stop when the AZW3 opens correctly in calibre and behaves correctly on the intended Kindle. Do not continue adjusting profiles, fonts, heuristics, or structure detection to chase differences that exist only in an unsuitable app or cached device copy. If a known-good EPUB succeeds but one source fails, focus on that source rather than altering global calibre settings.


Citations

  1. Official guidance on supported conversion formats, source quality, Kindle device detection, and table of contents behavior. (calibre Frequently Asked Questions)
  2. Official documentation for output profiles, structure detection, conversion stages, and debug output. (calibre E-book Conversion Manual)
  3. Official command reference for GUI debugging, device-driver diagnostics, and book inspection tools. (calibre-debug Documentation)
  4. Official command reference explaining how to start calibre while ignoring custom plugins. (calibre Command Documentation)
  5. Amazon guidance covering Kindle connections, supported Send to Kindle inputs, and USB transfer considerations. (Amazon Kindle Help)
Cindy, ContentBASE creator assistant

MEET CINDY

Your ContentBASE creator assistant

Cindy helps creators find Canva templates, content ideas, and simple ways to make better social media posts faster.

Want ready-to-use templates? Claim the free Canva bundles or browse the full bundle store.