Domino & Notes error

HTTP Web Server: Lotus Notes Exception - Invalid UNID; UNID must be a 32-digit hex string

The log line is usually followed by the requested URL, which shows the bad value.

What it means

The URL contains something where a document's universal ID should be, but it is not a valid 32-character hexadecimal UNID.

Common causes

  • A link was cut short, wrapped or mangled, for example in an email or by a script
  • Code builds the URL with the wrong value, such as a Note ID or an empty field
  • A view or link in the design points to a document key rather than a UNID

Quick fixes

  1. Read the URL in the log entry and check the UNID part is exactly 32 hexadecimal characters
  2. Fix the formula or code that builds the link, for example by using @Text(@DocumentUniqueID)
  3. If the link is inside the design, open and resave the design element that generates it

Need a hand with this?

Paste your exact message into What's That Error? for a plain-English explanation, or get in touch. I've been supporting Domino and Notes for 28 years.

Disclaimer

The errors, causes and fixes on this site are carefully researched, drawing on HCL documentation and 28 years of hands-on Domino and Notes experience. Every environment is different, though, and a solution that works in one may not be right for yours. Exact wording can also vary between Domino and Notes versions.

This information is general guidance only and is provided without warranty of any kind. Always back up your data and test changes on a non-production system first. To the extent permitted by law, Bruinsma Services Pty Ltd accepts no responsibility or liability for any loss, damage, downtime or other consequence arising from use of this information. For advice specific to your environment, please contact me.