EPUB Error: Cover Image Not Declared in OPF Manifest

Cover image is present in the EPUB package but not identified as the cover — KDP displays a gray placeholder; Apple Books may reject the file on submission

What causes this error?

EPUB 3 requires the cover image manifest entry to include properties="cover-image" so reading systems and distribution platforms know which image to use as the book's cover. When this attribute is absent, the image exists and is referenced in the manifest — basic validation passes — but the cover isn't identified as such. KDP falls back to a gray placeholder on the product page, and Apple Books Connect may reject the submission because it requires explicit cover identification. In EPUB 2, the equivalent is a <meta name="cover" content="id-of-cover-item" /> element in the OPF metadata block, where the content value matches the cover image manifest item's id. The most common cause is conversion tools that add the cover image to the manifest but omit the properties attribute — particularly when converting from DOCX or from older EPUB formats that predate the properties mechanism.

How to fix it

  1. Open content.opf and find the manifest item for your cover image — typically the entry for cover.jpg or Cover.png.
  2. Add properties="cover-image" to that item: <item id="cover-image" href="images/cover.jpg" media-type="image/jpeg" properties="cover-image" />.
  3. Confirm exactly one manifest item has properties="cover-image" — multiple items with this property are invalid.
  4. For EPUB 2 files, check that the OPF metadata block includes <meta name="cover" content="cover-image" /> where content matches the cover image's manifest id attribute.
  5. Re-validate with EPUBCheck to confirm the cover declaration is correct, then re-upload and verify the cover thumbnail appears in the platform preview.

Common questions

Why does KDP show my cover correctly in Kindle Previewer but display a gray placeholder on the product page?

Kindle Previewer finds the cover image by scanning the EPUB package directly. KDP's product page derives the cover from the properties="cover-image" declaration in the manifest — without it, the product listing falls back to a placeholder even if the image is physically present in the file.

Does every EPUB need this declaration, even if I upload a cover separately on KDP?

Yes — the properties="cover-image" declaration should be in every distributed EPUB regardless of whether the platform also takes a separate cover upload. Without it, reading apps may not display a cover thumbnail in the user's library even if the platform accepted the file.

Check your EPUB before uploading

The free EPUB Validator catches structure, metadata, and navigation errors — no signup, no Java, runs in the browser.

Validate Your EPUB Free →

Building your EPUB correctly from the start prevents most of these errors before they happen. See the EPUB formatting guide for the full workflow: manuscript cleanup, TOC, front matter, EPUB 3.0 generation, and validation.

Platform rejection guides: Why Amazon KDP rejects ebooks, Why Apple Books rejects ebooks, Why IngramSpark rejects books

Publishing checklists: EPUB formatting pre-upload checklist, KDP pre-launch checklist

Cover requirements: Amazon KDP ebook cover size requirements