Skip to content
EPUBCheck · Package document (OPF)

OPF-031

Updated:

EPUBCheck OPF-031 is an error message: “File listed in reference element in guide was not declared in OPF manifest: ….” A reference in the EPUB 2 guide element points to a file that is not in the manifest.

The official message

File listed in reference element in guide was not declared in OPF manifest: %1$s.

Default severity
Error. The EPUB breaks a rule of the specification and is invalid. Stores and Send to Kindle may reject it, and EPUBCheck exits with status 1.
EPUBCheck version
5.4.0

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

Typical causes

  • A guide entry left after a file was removed or renamed.

How to fix it

Terms used here

Other OPF messages

  • OPF-030 The unique-identifier "…" was not found.
  • OPF-029 The file "…" does not appear to match the media type …, as specified in the OPF file.
  • OPF-033 The spine contains no linear resources.
  • OPF-028 Undeclared prefix: "…".
  • OPF-034 The spine contains multiple references to the manifest item with id "…".
  • OPF-027 Undefined property: "…".

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

FAQ

What does EPUBCheck OPF-031 mean?

EPUBCheck OPF-031 is an error message: “File listed in reference element in guide was not declared in OPF manifest: ….” A reference in the EPUB 2 guide element points to a file that is not in the manifest.

Is OPF-031 an error?

OPF-031 is reported as error by default. The EPUB breaks a rule of the specification and is invalid. Stores and Send to Kindle may reject it, and EPUBCheck exits with status 1.