Skip to content

Symptom: the keyset loads, but a specific entry is rejected.

Because the rest of the file parsed successfully, the problem is local to one entry rather than to the file as a whole. That is useful: it rules out encoding and line endings, and points at formatting, naming or structure for a single line.

Likely causes

  • Formatting. A stray space, a missing separator or a tab where a space is expected.
  • Case. A name or value altered in case, which makes it a different token.
  • Length. An entry truncated or extended by an editing error.
  • Naming. An entry name that does not match what the parser expects, often after a manual edit or a partial copy-paste.

How to confirm

Run a local format validator and compare which entry it flags against the parser’s own message. If the same entry is flagged in both, it is a structural problem with that line.

Why not to fix it by hand

There is no integrity check in a keyset, so a hand-edited entry is indistinguishable from a corrupted one. Regenerating from the source is safer than repairing the line — see handling & storage.

Where this connects

Entry structure is described in the prod.keys file guide. If the flagged entry belongs to a category that the content expects at a different revision, the real issue may be a revision mismatch — see unsupported revision.