Skip to content
EPUBCheck · Package document (OPF)

EPUBCheck OPF-014: manifest property missing

Updated:

EPUBCheck OPF-014 is an error message: “The property "…" should be declared in the OPF file.” A content document uses a feature that must be declared on its manifest item, and the declaration is missing. EPUB requires these properties so reading apps know in advance which documents need SVG, MathML, scripting or network access.

The official message

The property "%1$s" should 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

  • Inline SVG in an XHTML document whose manifest item lacks properties="svg".
  • MathML without "mathml", or scripts (including forms or event attributes) without "scripted".
  • Audio, video or fonts loaded from the web without "remote-resources" on the manifest item.

How to fix it

  1. Read the property name and the file in the message.
  2. Add that property to the file's manifest item, for example <item id="c1" href="ch1.xhtml" media-type="application/xhtml+xml" properties="svg"/>.
  3. Separate several properties with spaces, such as properties="svg mathml".
  4. Run EPUBCheck again; if the feature was not intended, remove it from the document instead.

When it's not this

If the property is declared but the document does not use the feature, that is OPF-015, the opposite case.

Terms used here

Other OPF messages

  • OPF-013 Resource "…" is declared with MIME type "…" in content, but has MIME type "…" in the package document.
  • OPF-015 The property "…" should not be declared in the OPF file.
  • OPF-012 Item property "…" is not defined for media type "…".
  • OPF-016 The element "rootfile" is missing its required attribute "full-path".
  • OPF-011 itemref can’t have both page-spread-right and page-spread-left properties.
  • OPF-017 The attribute "full-path" on element "rootfile" must not be empty.

Sources

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

FAQ

What does EPUBCheck OPF-014 mean?

EPUBCheck OPF-014 is an error message: “The property "…" should be declared in the OPF file.” A content document uses a feature that must be declared on its manifest item, and the declaration is missing. EPUB requires these properties so reading apps know in advance which documents need SVG, MathML, scripting or network access.

Is OPF-014 an error?

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