Skip to content
EPUBCheck · Package and ZIP container

EPUBCheck PKG-014: empty folder in the EPUB

Updated:

EPUBCheck PKG-014 is a warning message: “The EPUB contains empty directory "…".” The EPUB archive contains an empty folder. It does no harm to reading apps, and EPUBCheck reports it only so you can remove what serves no purpose.

The official message

The EPUB contains empty directory "%1$s".

Default severity
Warning. The EPUB is still valid, but something is likely to cause problems in some reading apps. EPUBCheck exits with 0 unless you pass --failonwarnings.
EPUBCheck version
5.4.0

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

Typical causes

  • A folder left behind after moving or deleting files while editing the book.
  • A template that creates folders such as fonts or audio even when the book has none.

How to fix it

  1. Find the folder named in the message in the book's source.
  2. Delete the empty folder and rebuild the archive.
  3. Rebuild the archive with the mimetype file first and stored uncompressed, for example from the folder that contains the book: zip -X0 book.epub mimetype and then zip -rX9 book.epub META-INF OEBPS (use your own folder names).

When it's not this

It is unrelated to missing files: a reference to a file that is not there is RSC-007.

Terms used here

Other PKG messages

  • PKG-012 The file name "…" contains non-ASCII characters, which might create interoperability issues with older reading systems.
  • PKG-016 Use only lowercase characters for the EPUB file extension for maximum compatibility.
  • PKG-011 The file name "…" is not allowed to end with ".".
  • PKG-017 Uncommon EPUB file extension.
  • PKG-010 The file name "…" contains spaces, which may create interoperability issues with older reading systems.
  • PKG-018 The EPUB file could not be found.

Sources

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

FAQ

What does EPUBCheck PKG-014 mean?

EPUBCheck PKG-014 is a warning message: “The EPUB contains empty directory "…".” The EPUB archive contains an empty folder. It does no harm to reading apps, and EPUBCheck reports it only so you can remove what serves no purpose.

Is PKG-014 an error?

PKG-014 is reported as warning by default. The EPUB is still valid, but something is likely to cause problems in some reading apps. EPUBCheck exits with 0 unless you pass --failonwarnings.

PDF to EPUB tools

Every tool uses the same engine and starts with a free 5-page sample.