Domino & Notes error

Document is already locked by [user]

Can appear even when Allow document locking is off, because of temporary soft locks while a document is in edit mode.

What it means

Another user, or a stale lock, has the document locked, so you cannot edit it.

Common causes

  • Another user has the document open in edit mode
  • A lock left behind after a client crash or a document closed in edit mode
  • Leftover $Writers and $WritersDate items from document locking
  • Old client bugs with soft locks on new or back-end documents

Quick fixes

  1. Ask the named user to close the document, then try again
  2. Have the lock holder or a database Manager unlock it, for example with @DocLock([UNLOCK])
  3. If the lock is stale, an agent can remove the $Writers and $WritersDate items (back up first)
  4. Upgrade older clients; soft locks can be disabled with EDIT_NO_SOFT_LOCKS=1 in notes.ini

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.