EPUB Metadata and Publisher Checklist

Most EPUB distribution friction comes from metadata drift, not visible typography. Use this checklist to keep title, author, identifiers, language, and navigation metadata consistent before upload.

Lock your metadata before the final export

Settle the title, subtitle, author display name, and series naming before your final EPUB export.

Use one consistent author format everywhere so retailers do not split your author record into multiple versions.

If you use contributor roles, keep those names consistent across revisions too.

Check the required metadata fields

Make sure language code, unique identifier, publication date, and publisher fields are present and correct for this edition.

Decide on your identifier strategy on purpose, whether that means an ISBN or a platform-specific identifier.

Keep metadata text clean and simple. Watch out for hidden characters copied from old notes or drafts.

Check navigation and metadata in the same pass

Metadata and navigation should be checked together, not as two separate afterthoughts.

A clean table of contents does not help much if the title or author metadata is still wrong.

Run validator checks after any metadata change, not just after chapter edits.

Run final distributor-ready checks

Open the final EPUB in at least two reading environments and make sure title, author, and TOC behavior all look right.

Make sure the file you upload is the same one that passed the metadata check.

Keep one final validated EPUB per edition so you always know which file actually passed.

Numbers and Reference Tables

EPUB Metadata QA Reference

Field Pass signal Common failure pattern
Title + subtitle Matches your planned storefront listing and cover text An old working title is still inside the EPUB metadata.
Author/contributor Naming stays consistent everywhere A name variation creates duplicate author entries.
Language Valid language code (for example, en) Language field is missing or malformed.
Identifier Unique value that fits this edition strategy Identifier is missing or reused across editions.
Publisher/date Release metadata is current and intentional Placeholder metadata shipped by mistake.

Publish Checklist

  1. Lock the final title, subtitle, and author naming for this edition.
  2. Make sure metadata values match the planned storefront listing.
  3. Set a valid language code and confirm it is not empty.
  4. Choose the identifier strategy intentionally for this edition.
  5. Confirm publisher and publication date fields are current.
  6. Export a fresh EPUB from the final manuscript state.
  7. Run EPUB validation and note any metadata-related findings.
  8. Click TOC links to confirm navigation still works after metadata updates.
  9. Test title and author rendering in at least two reading environments.
  10. Upload only the validated EPUB and keep that exact file.

Warning-to-Fix Map

Warning pattern: missing required metadata field

Fix: Fill in the missing metadata field in source or export settings and regenerate the EPUB.

Verify: Validator reports no missing core metadata errors.

Warning pattern: invalid language code

Fix: Replace the malformed language value with a valid language tag.

Verify: The language warning clears in validation output.

Warning pattern: duplicate or conflicting identifier

Fix: Choose one clear identifier strategy per edition and remove stale identifier entries.

Verify: Validator and distributor precheck show one valid unique identifier.

Warning pattern: storefront shows the wrong title or author

Fix: Match the EPUB package metadata to your final release metadata, then export again.

Verify: Reader and device metadata display matches the listing text you intend to use.

Warning pattern: metadata fix caused a navigation problem

Fix: Rerun TOC and reading-order checks after metadata edits before final upload.

Verify: Both metadata and navigation checks pass on the same file.

Warning pattern: issue persists after correction

Fix: Confirm validator and distributor checks are using the newest export and remove stale local copies.

Verify: The newly named EPUB passes metadata checks cleanly.

The Senswriter way (faster)

Use the same workflow in one workspace: draft, export, run checks, fix the source, and upload one clean final file.

Open the Senswriter Workspace and see export examples.

Frequently Asked Questions

Can clean formatting still fail distribution because of metadata?

Yes. A visually correct EPUB can still be rejected or ingested poorly when required metadata is missing or inconsistent.

Should I reuse one identifier across all editions?

Use a deliberate identifier strategy for each edition and platform. Avoid accidental reuse that creates catalog conflicts.

When should I rerun metadata checks?

After any change to title, author naming, language, identifier, publisher, or major export settings.

Sources and Claim Checks