How to Edit EPUB Metadata with Calibre: Complete Guide 2026
Why EPUB Metadata Matters More Than You Think
You download an EPUB, drop it into your e-reader, and — instead of a clean library listing — you see "untitled" or "unknown_author_v3_final" sitting in your bookshelf. The cover is missing. The series field is blank. Your carefully organized collection is a mess.
This is a metadata problem, and it's the single most common frustration for anyone who works with EPUB files. Metadata is the invisible data inside every ebook: the title, author name, publisher, ISBN, cover image, language, tags, and series information. When it's wrong or missing, your e-reader cannot display the book properly, library apps sort it incorrectly, and tools like Calibre can't identify duplicates.
The good news: fixing EPUB metadata is straightforward. Calibre, the free and open-source ebook manager, gives you complete control over every metadata field in any EPUB file. This guide walks you through every step — from basic title fixes to advanced bulk editing — so your library stays spotless in 2026.
What Is EPUB Metadata?
Every EPUB file contains a hidden XML file called content.opf that stores metadata. Think of it as the book's ID card. The EPUB 3.4 specification defines standard fields that all e-readers and library tools recognize:
| Field | Purpose | Example |
|---|---|---|
dc:title | Book title | "The Great Gatsby" |
dc:creator | Author name | "F. Scott Fitzgerald" |
dc:publisher | Publisher | "Scribner" |
dc:date | Publication date | "2025-04-10" |
dc:identifier | ISBN or unique ID | "978-0-7432-7356-5" |
dc:language | Language code | "en" |
meta cover | Cover image reference | "cover.jpg" |
Calibre adds its own fields on top of these: tags (genres), series name and number, ratings, comments (descriptions), and custom columns you define yourself.
Installing Calibre (If You Haven't Already)
Calibre runs on Windows, macOS, and Linux. If you don't have it installed, grab the latest version from calibre-ebook.com/download. The current stable release as of July 2026 is Calibre 9.11, which added HTML annotation export and improved AI query support in the ebook viewer.
Installation is straightforward:
- Windows: Download the installer and run it. The setup wizard handles everything.
- macOS: Download the .dmg, drag Calibre to Applications.
- Linux: Use the official install script:
sudo -v && curl -sSL https://calibre-ebook.com/linux-installer.sh | sudo sh /dev/stdin
Once installed, launch Calibre. You'll be prompted to choose a library folder — this is where Calibre stores copies of your books and their metadata database. Pick a location with enough free space.
Adding EPUBs to Your Calibre Library
Before you can edit metadata, the EPUB must be inside Calibre's library. You have two ways to add books:
Method 1 — Drag and Drop: Simply drag an EPUB file from your file manager into the Calibre window. The book appears immediately in your library view.
Method 2 — Add Books button: Click the Add books button in the top-left toolbar (or press Ctrl+O on Windows/Linux, Cmd+O on macOS). Select one or more EPUB files and click Open.
Calibre imports the file, reads its existing metadata, and stores a copy in its library folder. The original file is untouched — Calibre never modifies the source file directly. All metadata edits are stored in Calibre's database first, then written back to the EPUB when you export.
Editing Metadata for a Single Book
To edit metadata for one EPUB:
- Select the book in your library list.
- Click the Edit metadata button (the pencil icon in the toolbar, or press Ctrl+D on Windows/Linux, Cmd+D on macOS).
- The "Edit metadata" dialog opens with all fields visible.
Here's what each section does:
Title and Author
The most frequently edited fields. If Calibre imported a book with a garbled title like "gatsby_final_epub_v2", simply type the correct title in the Title field. For the Author field, use "Last, First" format — Calibre automatically sorts books by author's last name.
Click the pencil icon next to the Author field to set a sort name explicitly. This helps if you have multiple authors with similar names.
Cover Image
Missing or wrong covers are one of the top complaints about sideloaded EPUBs. To replace the cover:
- Click the current cover thumbnail in the top-left of the dialog.
- Select Browse and pick a JPG or PNG image from your computer.
- Calibre automatically resizes and embeds the new cover into the EPUB.
Aim for a cover image around 1600×2400 pixels at 72 DPI for the best balance of quality and file size. Larger images bloat the EPUB without visible improvement on e-ink screens.
Series Information
For books that belong to a series (think Harry Potter, The Expanse, or Wheel of Time), set the Series field and Number field. Calibre sorts these automatically in your library, and most e-readers display them in order when you transfer the books.
Tags
Tags are Calibre's version of genres or categories. Common tags include "Fiction", "Science Fiction", "Fantasy", "History", "Biography", "Technology". You can assign multiple tags to a single book, separated by commas. Tags are fully searchable and filterable in Calibre's library view.
Comments (Description)
The Comments field stores the book's description or blurb. This is what e-readers show when you browse your library on a Kindle or Kobo. Paste your description here, and Calibre embeds it in the EPUB's metadata when you export.
IDs
The IDs section lets you set ISBN, Google Books ID, Amazon ASIN, and other identifiers. Calibre uses these to download metadata and covers automatically (more on this below). To add an ISBN, enter isbn:9780743273565 in the IDs field.
Automatic Metadata and Cover Download
Calibre can fetch correct metadata and covers from online sources automatically — a huge time-saver when you have a large library.
- Select the book (or books) with missing or incorrect metadata.
- Click Edit metadata → Download metadata (or right-click and choose Download metadata and covers).
- Calibre searches Google Books, Amazon, Open Library, and other sources for matching records.
- Review the results in the dialog. Calibre shows you the best match with its title, author, cover, and description. If multiple matches appear, pick the one that looks correct.
- Click OK to apply the downloaded metadata.
Calibre downloads all standard fields: title, author, publisher, publication date, ISBN, tags, and a high-quality cover image. This is the fastest way to fix a library of poorly-tagged EPUBs.
Tip: If the automatic search returns wrong results, add the correct ISBN in the IDs field first, then try again. Calibre uses the ISBN as a primary lookup key, which dramatically improves match accuracy.
Bulk Editing Multiple EPUBs at Once
When you have a folder full of EPUBs with the same problem — all missing tags, or all with wrong publisher info — bulk editing saves hours.
- Select multiple books in the library view (Ctrl+Click to pick individual books, Shift+Click for a range).
- Click Edit metadata → Edit metadata in bulk (or press Ctrl+Shift+D).
- The bulk edit dialog shows fields you can apply to all selected books at once.
- Check the box next to each field you want to change, then enter the new value.
For example, to add the tag "Classic Literature" to twenty classic novels at once: select all twenty books, open bulk edit, check the "Tags" box, type "Classic Literature", and click OK. Every selected book gets the tag.
Bulk editing is also useful for setting a common publisher, cleaning up language codes, or adding a series if you have all volumes of a series imported as separate files.
Advanced: Direct OPF Editing
For metadata that the standard editor doesn't cover — such as calibre:user_metadata, custom identifiers, or embedded font declarations — you can edit the OPF file directly:
- Right-click the book in Calibre's library.
- Select Edit book → Unpack book folder (OPF file).
- Calibre opens the built-in editor. Find and open
content.opfin the file tree on the left. - Edit the XML manually. The OPF structure is well-documented and follows the standard EPUB 3 schema.
- Save your changes (Ctrl+S) and close the editor.
This approach is powerful but dangerous — a syntax error in the OPF can make the EPUB unreadable. Only use direct editing when the standard metadata editor doesn't expose the field you need, and always make a backup of the original file first.
Exporting the Fixed EPUB
After editing metadata, you need to write the changes back into the EPUB file. Calibre does this automatically when you export a book:
- Save to disk: Right-click the book and choose Save to disk → Save only EPUB format to disk. Calibre writes the updated EPUB to your chosen folder with the corrected metadata embedded. The file is ready to transfer to any e-reader.
- Send to device: Connect your Kindle, Kobo, or PocketBook via USB. Select the book and click Send to device. Calibre converts (if needed), applies the metadata, and transfers the file in one step.
- Email: Use Calibre's built-in email feature to send the fixed EPUB to your Send to Kindle email address or Kobo's Pocket service.
The exported EPUB contains all your metadata edits — title, author, cover, series, tags, descriptions — and will display correctly on any e-reader that supports EPUB.
Best Practices for EPUB Metadata
These habits keep your library clean and save you from re-editing the same books later:
- Set metadata immediately on import. Don't let bad metadata pile up. Edit as soon as you add a book to Calibre. A minute now saves ten minutes of cleanup later.
- Use consistent tag naming. Decide on a tag scheme and stick to it. "Science fiction" and "Sci-Fi" are the same concept but Calibre treats them as separate tags. Pick one format and use it everywhere.
- Always add an ISBN. The ISBN is the most reliable identifier for matching books. It prevents duplicates and makes auto-downloading metadata accurate.
- Keep covers reasonably sized. A 5MB cover image bloats your EPUB and slows down page turns on older e-readers. Use JPEG at quality 80-90%, dimensions around 1600×2400 pixels.
- Back up your Calibre library folder. The entire database lives in your chosen library directory. Copy it to a backup drive or cloud storage. If you ever lose your library, you lose all the metadata you painstakingly edited.
- Run the Quality Check plugin. Calibre has a community plugin called Quality Check that scans your library for common metadata problems: missing covers, empty descriptions, invalid ISBNs, and inconsistent tags. Install it from Calibre's Preferences → Plugins → Get new plugins.
Frequently Asked Questions
Does editing metadata in Calibre change the original EPUB file?
No. Calibre stores a copy of every imported EPUB in its library folder. All metadata edits are kept in Calibre's internal database. The changes are only written into the EPUB file when you export (Save to disk or Send to device). The original import file is never modified.
Can I edit metadata for EPUB files without Calibre?
Yes, but it's more work. You can rename an EPUB to .zip, extract it, edit content.opf in a text editor, re-zip, and rename back to .epub. Tools like Sigil (a dedicated EPUB editor) also offer metadata editing. However, Calibre is by far the easiest and most reliable method, especially for batch operations.
Will my e-reader display Calibre-edited metadata correctly?
Yes. Calibre writes standard EPUB metadata that all modern e-readers understand — Kindle (after conversion to AZW3), Kobo, PocketBook, and apps like Google Play Books and Apple Books. The title shows up correctly in your library, the cover displays, and series information is recognized.
How do I fix an EPUB with no cover in Calibre?
Open the book's Edit metadata dialog. Click the cover thumbnail area and select Browse to upload a new image file (JPG or PNG). Calibre embeds the new cover the next time you save the book to disk. If the EPUB has a cover reference but it's not displaying, try running the Polish books tool (Preferences → Polishing) which fixes common cover-reference issues automatically.
Can I batch-edit metadata for 100+ EPUBs at once?
Yes. Select all books, click Edit metadata → Edit metadata in bulk. You can set common fields (tags, language, publisher) across the entire selection at once. For per-book changes like titles and authors, use the Download metadata feature which queries online databases for each book individually.
Editing EPUB metadata in Calibre is one of those skills that pays for itself ten times over. Ten minutes spent fixing the metadata on a batch of imports saves hours of frustration later — and it means your library always looks as good as the books deserve.