Skip to content
EPUBCheck · Package document (OPF)

EPUBCheck OPF-097: manifest file never used

Updated:

EPUBCheck OPF-097 is a usage message: “Resource "…" is listed in the manifest, but no reference to it was found in content documents.” A file is listed in the manifest but nothing in the content references it. It is a usage note (shown with -u): the file is valid but probably unused, which makes the EPUB larger for no reason.

The official message

Resource "%1$s" is listed in the manifest, but no reference to it was found in content documents.

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

  • Images, fonts or stylesheets left after editing.
  • Files a template adds to every book.
  • A reference written in a way EPUBCheck cannot follow, such as from a script.

How to fix it

  1. Read the file EPUBCheck names.
  2. If the book does not need it, delete the file and its manifest item.
  3. If it is needed, make sure the content references it with a correct path.

When it's not this

If a file is in the archive but missing from the manifest, that is OPF-003, the opposite case.

Terms used here

Other OPF messages

  • OPF-096 Non-linear content must be reachable, but found no hyperlink to "…".
  • OPF-096b No hyperlink was found to non-linear document "…", please check that it can be reached from scripted content.
  • OPF-098 The "href" attribute must reference resources, not elements in the package document, but found URL "…".
  • OPF-095 The "media-type" attribute of "voicing" links must be an audio MIME type, but found "…".
  • OPF-099 The manifest must not list the package document.
  • OPF-094 The "media-type" attribute is required for "…" links.

Sources

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

FAQ

What does EPUBCheck OPF-097 mean?

EPUBCheck OPF-097 is a usage message: “Resource "…" is listed in the manifest, but no reference to it was found in content documents.” A file is listed in the manifest but nothing in the content references it. It is a usage note (shown with -u): the file is valid but probably unused, which makes the EPUB larger for no reason.

Is OPF-097 an error?

OPF-097 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.