Skip to content
EPUBCheck · Package document (OPF)

EPUBCheck OPF-015: unneeded manifest property

Updated:

EPUBCheck OPF-015 is an error message: “The property "…" should not be declared in the OPF file.” A manifest item declares a property that the document does not actually use, such as svg, mathml or scripted. EPUB asks for these properties to match the content, so a stale one is reported as an error.

The official message

The property "%1$s" should not be declared in the OPF file.

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

  • Properties copied from a template manifest that declared them for every chapter.
  • The SVG, MathML or script was removed from the document, but the property stayed.
  • A tool that adds properties by guessing from file names instead of reading the content.

How to fix it

  1. Read the property and the file EPUBCheck names.
  2. Open the document and confirm it really contains no such element (svg, math or script).
  3. Remove the property from that manifest item, keeping any other properties it has.

When it's not this

If the document uses the feature and the property is missing, that is OPF-014.

Terms used here

Other OPF messages

  • OPF-014 The property "…" should be declared in the OPF file.
  • OPF-016 The element "rootfile" is missing its required attribute "full-path".
  • OPF-013 Resource "…" is declared with MIME type "…" in content, but has MIME type "…" in the package document.
  • OPF-017 The attribute "full-path" on element "rootfile" must not be empty.
  • OPF-012 Item property "…" is not defined for media type "…".
  • OPF-018 The "remote-resources" property was declared in the Package Document, but no reference to remote resources has been found.

Sources

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

FAQ

What does EPUBCheck OPF-015 mean?

EPUBCheck OPF-015 is an error message: “The property "…" should not be declared in the OPF file.” A manifest item declares a property that the document does not actually use, such as svg, mathml or scripted. EPUB asks for these properties to match the content, so a stale one is reported as an error.

Is OPF-015 an error?

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