Skip to content
EPUBCheck · EPUBCheck configuration

EPUBCheck CHK-008: item skipped after an error

Updated:

EPUBCheck CHK-008 is an error message: “Error encountered while processing an item "…"; skip other checks for the item.” EPUBCheck hit an unexpected problem while processing one item of the EPUB and skipped the remaining checks for that item. The message names the item; the rest of the book is still checked.

The official message

Error encountered while processing an item "%1$s"; skip other checks for the item.

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 file EPUBCheck could not process completely, such as a damaged or unusual resource.
  • An internal problem in EPUBCheck triggered by unusual content.

How to fix it

  1. Note the item named in the message and check that it opens on its own (an image viewer, a browser or an XML editor).
  2. Re-export or replace the item from its source and validate again.
  3. If the item is fine and the message persists with the latest EPUBCheck, report it to the EPUBCheck project on GitHub with a minimal file.

When it's not this

It is not about the custom message file passed with -c; those problems are CHK-001 to CHK-007.

Terms used here

Other CHK messages

  • CHK-001 The custom message overrides file was not found.

Sources

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

FAQ

What does EPUBCheck CHK-008 mean?

EPUBCheck CHK-008 is an error message: “Error encountered while processing an item "…"; skip other checks for the item.” EPUBCheck hit an unexpected problem while processing one item of the EPUB and skipped the remaining checks for that item. The message names the item; the rest of the book is still checked.

Is CHK-008 an error?

CHK-008 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.