Domino & Notes error

Invalid universal id

Usually reported as a Notes error by GetDocumentByUNID.

What it means

The code asked for a document by its Universal ID, but no document with that UNID exists in the database, or the UNID text is invalid.

Common causes

  • The document was deleted, or lives in a different replica or database
  • The UNID is stored with the wrong length or extra characters
  • Using a Note ID where a Universal ID is expected

Quick fixes

  1. Trap the error and handle missing documents, for example with On Error around GetDocumentByUNID
  2. Check the UNID is exactly 32 hexadecimal characters
  3. Make sure the code opens the correct database or replica

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.