Skip to content
EPUBCheck · EPUBCheck configuration

CHK-002

Updated:

EPUBCheck CHK-002 is an error message: “Unrecognized custom message id … encountered in message overrides file "…".” The custom message file contains a message ID EPUBCheck does not know.

The official message

Unrecognized custom message id %1$s encountered in message overrides file "%2$s".

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 typo in a code, or a code from another EPUBCheck version.

How to fix it

  • This is a problem with the file passed to EPUBCheck's -c (--customMessages) option, not with the EPUB. Fix the custom message file or run EPUBCheck without -c.
  • To start from a correct file, run EPUBCheck with -l (--listChecks) to write the list of message IDs and their severities, then edit that list.

Terms used here

Other CHK messages

  • CHK-001 The custom message overrides file was not found.
  • CHK-003 Unrecognized custom message severity "…" encountered in message overrides file "…".
  • CHK-007 Error encountered while processing custom message file "…": "…".

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

FAQ

What does EPUBCheck CHK-002 mean?

EPUBCheck CHK-002 is an error message: “Unrecognized custom message id … encountered in message overrides file "…".” The custom message file contains a message ID EPUBCheck does not know.

Is CHK-002 an error?

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