Skip to content
EPUBCheck · Package and ZIP container

PKG-027

Updated:

EPUBCheck PKG-027 is a fatal error message: “Could not extract EPUB ZIP content, probably due to file names not encoded in UTF-8.” EPUBCheck could not extract the archive, most likely because the file names inside the ZIP are not encoded in UTF-8.

The official message

Could not extract EPUB ZIP content, probably due to file names not encoded in UTF-8.

Default severity
Fatal error. EPUBCheck could not continue checking this part of the EPUB. The file is invalid.
EPUBCheck version
5.4.0

Typical causes

  • A ZIP created by an old tool or on a system that stores file names in a local code page, often with accented characters in the names.

How to fix it

  • Rename files to ASCII names, or rebuild the archive with a tool that stores names in UTF-8.
  • 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).

Terms used here

Other PKG messages

  • PKG-026 Obfuscated resource must be a Font Core Media Type (was declared as "…" in "…").
  • PKG-025 Publication resource must not be located in the META-INF directory
  • PKG-024 Uncommon EPUB file extension.
  • PKG-022 Wrong file extension for image. The image is a "…" file but has the file extension "…".
  • PKG-021 Corrupted image file encountered.
  • PKG-017 Uncommon EPUB file extension.

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

FAQ

What does EPUBCheck PKG-027 mean?

EPUBCheck PKG-027 is a fatal error message: “Could not extract EPUB ZIP content, probably due to file names not encoded in UTF-8.” EPUBCheck could not extract the archive, most likely because the file names inside the ZIP are not encoded in UTF-8.

Is PKG-027 an error?

PKG-027 is reported as fatal error by default. EPUBCheck could not continue checking this part of the EPUB. The file is invalid.