calibre Save to Disk Folder Structure Wrong: How to Fix Templates

If the calibre Save to disk folder structure is wrong, the cause is usually an export template, incomplete metadata, the selected Save to disk command, or a destination-folder conflict. The problem is rarely fixed by rearranging calibre’s internal library folders. Those folders are managed automatically and are separate from the customizable folders calibre creates when exporting books. Use the steps below to test one book, correct the relevant template, and stop as soon as the exported path matches your intended structure.

1. Confirm the Symptom With a Small Safe Test

Begin with one or two books whose metadata you can recognize easily. Do not test by exporting your entire library. A small selection makes it easier to see which fields calibre used and prevents hundreds of incorrectly named folders from being created.

1.1 Create a clean destination folder

Create an empty folder outside your calibre library, such as Calibre Export Test in your Documents folder. Do not export into the calibre library folder, an existing author folder, or a folder already containing previous exports.

Select one book in calibre, right-click the Save to disk button, and choose the normal Save to disk command. Inspect the resulting folders and files. Record the actual path and compare it with what you expected.

For example, you might expect:

Isaac Asimov/Foundation/03 - Second Foundation.epub

Instead, calibre might create:

Asimov, Isaac/Second Foundation/Second Foundation - Isaac Asimov.epub

If calibre completes the export and consistently creates the second structure, the feature is working. Its current template or metadata simply differs from your expectation.

1.2 Confirm which Save to disk command you selected

The Save to disk menu contains multiple commands. They do not all produce the same result:

• Save to disk uses the configured folder structure and normally exports all available formats.
• Save to disk in a single folder intentionally removes the nested folder structure.
• Save only the preferred format uses the configured structure but limits the exported book format.
• Save only the preferred format in a single folder limits the format and flattens the structure.
• Save single format to disk lets you choose a specific available format.

If everything appears in one folder, repeat the test with the normal Save to disk command. Success means the author, series, or title subfolders now appear. If they do, stop changing settings because the original issue was the selected command, not the template.

2. Check the Save to Disk Template and Metadata

Open Preferences > Import/export > Saving books to disk. The saving template in this section controls the relative path created beneath the destination folder. Template fields in braces are replaced with metadata from each selected book.

2.1 Understand the basic template fields

The most useful fields for ordinary exports are:

• {title} for the displayed book title
• {authors} for the displayed author name or names
• {author_sort} for the author’s sorting form
• {series} for the series name
• {series_index} for the book’s position in its series
• {id} for calibre’s record identifier

A slash written between expressions creates another folder level. For example:

{authors}/{title}

This normally produces an author folder containing a title folder or file path. A more detailed series-oriented template is:

{authors}/{series}/{series_index} - {title}

However, that simple template can leave an unnecessary level or awkward punctuation when the series field is empty. A conditional form is often better:

{authors}/{series:||/}{series_index:|| - }{title}

In this form, the series folder and index separator appear only when the series metadata exists. Test it with one series book and one standalone book. Success means the series book enters a series subfolder while the standalone title does not receive an empty or meaningless series folder.

2.2 Choose between authors and author sort

The fields {authors} and {author_sort} can produce visibly different folders. If the author is Isaac Asimov, {authors} may produce Isaac Asimov, while {author_sort} may produce Asimov, Isaac.

Neither result is inherently wrong. Choose the field that matches how you want folders displayed. If the result is unexpected, open Edit metadata for the test book and inspect both the author and author-sort values. Correct the metadata rather than trying to compensate for a bad value with complicated literal text.

After editing the metadata, export the book into a newly emptied test folder. Success means the folder name now follows the corrected author value. Stop there if the path is correct.

2.3 Verify title, series, and series index metadata

A template cannot create reliable series folders when the book record has no series information. Select the book, open Edit metadata, and check:

• The title does not contain an accidental subtitle, edition note, or filename fragment
• The author field contains the intended author name
• The author-sort field uses the desired order
• The series field contains the correct series name
• The series index is correct

If several books should be in the same series, verify that the series spelling is identical. Differences in capitalization, spacing, or punctuation can create multiple folders that look nearly identical.

Success means books with matching metadata are exported into the same intended author or series folder. If that happens, do not change plugins, conversion settings, or the internal library.

2.4 Account for filename-safe metadata

Operating systems reserve or restrict certain filename characters. calibre cleans metadata values when using them in Save to disk paths, replacing filesystem-sensitive characters as needed. A slash inside a title, for example, is treated as part of the metadata and made safe instead of automatically becoming a folder boundary.

This distinction matters:

• A slash typed directly into the template separates folders.
• A slash originating inside a title, author, or series value is sanitized for safe filename use.

Do not insert slashes into a book’s title to force new folders. Put folder separators in the template itself. Success means the export completes without invalid-path errors and metadata containing punctuation produces safe names.

2.5 Prevent duplicate filenames

Two records can produce the same path when they share identical template fields. This commonly happens with different editions, languages, or formats of the same title. Depending on the destination and operation, existing files can be replaced, merged into the same folder, or exported with results that appear incomplete.

Add a genuinely distinguishing field when duplicates are possible. For example:

{authors}/{title} - {id}

The calibre record ID is practical for uniqueness, although it is less attractive for human browsing. You can instead use properly maintained metadata such as series, language, or another suitable field. Test two known duplicate titles together. Success means each record receives a distinct path and both exports remain present.

3. Check Format Selection and Related Features

A correct folder template does not guarantee that every expected file format will be exported. The selected Save to disk variation determines whether calibre saves every available format, the preferred format, or one format chosen at export time.

3.1 Confirm which formats the book actually contains

Select the book and inspect its available formats in the book details or Edit metadata window. A book with EPUB and PDF formats can export both when using the standard Save to disk command. A preferred-format command exports only the preferred format when it is available.

If the folder exists but the expected file is absent, right-click Save to disk and choose Save single format to disk. Select the exact format you want. Success means that format appears under the path generated by the template.

Conversion settings do not normally determine the Save to disk folder structure. Conversion may create a new format, but the export path still comes from the Save to disk template and the book’s library metadata.

3.2 Do not confuse Save to disk with Send to device

Save to disk and Send to device have separate template settings. Changing the device template does not necessarily alter an ordinary disk export. Likewise, fixing the disk-saving template might not change folders on an e-reader.

If the incorrect structure appears only on a connected reader, review Preferences > Import/export > Sending books to devices instead. Device capabilities and driver behavior can also affect where files are placed. If the same book exports correctly to a normal local folder, the Save to disk template is no longer the problem.

3.3 Check metadata plugboards only when embedded metadata is wrong

Metadata plugboards can change metadata written into exported book files. They do not control the filenames generated by the Save to disk path template. If the external folder is correct but the title displayed after opening the EPUB is different, a plugboard may be relevant. If the folder itself is wrong, return to the Saving books to disk template.

Email sharing, the Content server, news downloads, the viewer, and the editor also use their own workflows. They should not be adjusted to fix an ordinary Save to disk folder path unless testing shows that the problem occurs only in one of those features.

4. Check the Destination and Operating System

Operating system issues usually cause errors, missing output, shortened names, or files that seem to disappear. They do not normally transform a valid template into a completely different logical hierarchy.

4.1 Test a local writable folder

Export to a new folder in Documents or another location owned by your user account. Avoid protected system directories, application folders, read-only removable media, and network locations during diagnosis.

On Windows, also avoid unnecessarily long destination paths. On macOS and Linux, verify that your user account can create folders and files in the selected location. If a local test works but the original destination fails, the template is correct. Stop editing it and investigate permissions or the destination filesystem instead.

4.2 Pause cloud sync during the test

Cloud-sync software can rename conflicts, restore deleted folders, or delay visible changes. Create the temporary test folder outside OneDrive, iCloud Drive, Dropbox, or another synchronized location. Export the same book twice after emptying the folder between tests.

Success means the local unsynchronized folder is correct and stable. The remaining problem is the cloud workflow, an existing conflicting path, or synchronization timing.

4.3 Treat USB exports as a separate test

If the destination is a USB drive or mounted reader, first export to the computer’s internal storage. Then copy the resulting test folder to the USB destination using the operating system.

If Save to disk works locally but fails directly on the removable destination, check free space, write protection, mount permissions, filesystem limitations, and the device’s supported naming rules. Changing the calibre template is unnecessary unless the device requires shorter or simpler names.

5. Use Debug Information Only When the Export Fails

Most folder-structure problems are solved by inspecting the chosen command, template, and metadata. Debug output becomes useful when calibre reports an exception, a plugin interferes, or no files appear despite a writable destination.

5.1 Read job details and error messages

Open calibre’s Jobs area after the export. If a job failed, view its details and note the first meaningful path or permission error. Look for an invalid destination, denied access, an excessively long path, a missing source format, or a plugin-related traceback.

Do not treat a successfully completed job as evidence of a software failure merely because the folder arrangement is unexpected. A successful job with repeatable but unwanted names points back to the template or metadata.

5.2 Start calibre in debug mode when needed

For persistent unexplained failures, restart calibre in debug mode by right-clicking the Preferences button and choosing the debug restart option. Reproduce the problem with one book, close calibre, and inspect the generated log.

Advanced users can launch the graphical interface with calibre-debug -g. On macOS, calibre command-line tools are located inside the application bundle unless their directory has been added to the shell path. Debug mode is primarily useful for exceptions and plugin problems, not for designing an ordinary template.

5.3 Temporarily exclude plugin involvement

If the behavior began after installing or updating a plugin, restart calibre without relying on that plugin’s actions and repeat the built-in Save to disk test. Use the toolbar’s standard Save to disk command rather than a plugin-provided export command.

Success means the built-in operation produces the expected path. At that point, keep the working calibre template and review the plugin’s own configuration or support information.

6. Run a Clean Temporary Test Before Reinstalling

Reinstalling calibre usually preserves its existing configuration, so it may not change a bad Save to disk template. Deleting the library is much riskier and is not an appropriate response to an export naming problem.

1. Create an empty local destination folder.
2. Select one book with verified title and author metadata.
3. Use a simple template such as {authors}/{title}.
4. Choose the normal Save to disk command.
5. Inspect the exported path.
6. Add series logic only after the simple template works.
7. Test two or three books before exporting a large selection.

If the simple template works, calibre itself is functioning. Add one field or conditional element at a time until the desired result is reached. Stop changing settings immediately after a clean test produces the correct folders and files.

6.1 Why changing internal library folders is the wrong fix

The calibre library is managed by calibre. Its author and title directories are implementation details, not a user-defined export filing system. Manually moving, renaming, adding, or deleting items inside that library can separate files from their database records or cause changes to be overwritten.

Use Save to disk when you want a separate, human-readable folder structure. Keep the internal library intact and let calibre manage it. If you need to move the entire library, use calibre’s library-management controls rather than manually reorganizing individual book folders.

7. Quick Fix Checklist

• Test one or two books in a new empty local folder.
• Use normal Save to disk, not the single-folder variation.
• Open Preferences and check the Saving books to disk template.
• Use template slashes for folder boundaries.
• Verify title, authors, author sort, series, and series index.
• Use {authors} or {author_sort} according to your preferred display.
• Add conditional series separators when standalone books need no series folder.
• Choose the correct export command for all formats, a preferred format, or one format.
• Add a unique field if separate records generate duplicate paths.
• Test outside cloud storage, network shares, USB drives, and protected folders.
• Check job details only if the export fails or files are missing.
• Do not manually reorganize the internal calibre library.
• Stop changing settings once a clean test produces the intended path.

8. Frequently Asked Questions

8.1 What template creates author, series, and title folders?

A practical starting point is {authors}/{series:||/}{series_index:|| - }{title}. It creates an author folder, adds a series folder only when series metadata exists, and prefixes series titles with their index. Test it on both a series book and a standalone book before applying it broadly.

8.2 Why does calibre use Last Name, First Name for the folder?

Your template probably uses {author_sort}. Replace it with {authors} if you prefer the displayed author order. Alternatively, correct the author-sort metadata if you want to retain sortable names but the stored value is wrong.

8.3 Why are all exported books in one folder?

You may have selected a Save to disk variation that explicitly uses a single folder. Repeat the export with the normal Save to disk command. Also confirm that your template contains literal slashes between the fields that should form folder levels.

8.4 Why is the series folder missing?

Open Edit metadata and confirm that the series field is populated for the affected book. An empty field produces an empty template result. If only some books lack the folder, inconsistent metadata is more likely than a global template failure.

8.5 Why did calibre export EPUB but not PDF?

You may have chosen a preferred-format or single-format command, or the book record may not contain a PDF. Check the formats stored with the book, then choose normal Save to disk for all formats or Save single format to disk for a specific one.

8.6 Can I change calibre’s internal folders to match my export template?

No. The internal library structure is controlled by calibre and should not be manually reorganized. Save to disk exists specifically for creating a separate folder and filename structure based on your metadata. Once that export matches your goal, leave the internal library unchanged.