Skip to content
EPUBCheck · Package document (OPF)

OPF-003

Updated:

EPUBCheck OPF-003 is a usage message: “Item "…" exists in the EPUB, but is not declared in the OPF manifest.” A file is in the archive but not declared in the manifest, so reading apps may ignore it.

The official message

Item "%1$s" exists in the EPUB, but is not declared in the OPF manifest.

Default severity
Usage. Informative only and hidden by default: it appears when EPUBCheck runs with -u (--usage). It does not make the EPUB invalid.
EPUBCheck version
5.4.0

%1$s, %2$s… are filled in with the file, value or element EPUBCheck found.

Typical causes

  • Leftover files such as .DS_Store, Thumbs.db, old images or backups zipped with the book.
  • A new file added to the folder without updating the manifest.

How to fix it

  • Delete files the book does not use, or add a manifest item for files it does.

Terms used here

Other OPF messages

  • OPF-002 The OPF file "…" was not found in the EPUB.
  • OPF-004 Invalid prefix declaration: leading or trailing whitespace is not allowed.
  • OPF-004a Invalid prefix declaration: found empty prefix.
  • OPF-004b Invalid prefix "…": must be a valid non-colonized name (aka "NCName").
  • OPF-004c Invalid prefix declaration: prefix "…" must be immediately followed by a colon character (":").
  • OPF-004d Invalid prefix declaration: prefix "…" must be separated by its URI with a space.

Message text and severity from EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Explanation by EPUBLab.

FAQ

What does EPUBCheck OPF-003 mean?

EPUBCheck OPF-003 is a usage message: “Item "…" exists in the EPUB, but is not declared in the OPF manifest.” A file is in the archive but not declared in the manifest, so reading apps may ignore it.

Is OPF-003 an error?

OPF-003 is reported as usage by default. Informative only and hidden by default: it appears when EPUBCheck runs with -u (--usage). It does not make the EPUB invalid.