RemovePermanently (NotesDocument - LotusScript®)

Permanently deletes a document from a database, doing a hard deletion even if soft deletions are enabled.

Note: This method is new with Release 6.

Defined in



flag = notesDocument .RemovePermanently( force )



Boolean. If True, the document is deleted even if another user modifies the document after the script opens it. If False, the document is not deleted if another user modifies it.

Return value

  • True indicates that the document was successfully deleted.
  • False indicates that the document was not deleted, because another user modified it and the force parameter is set to False.


This method does a hard deletion even if "Allow soft deletions" is enabled. See Remove to do a soft deletion.

If you access a NotesDocument object through the Document property of NotesUIDocument, you can't delete the back-end document. If you could, the UI rendition would have no basis. You must access the document strictly through the back-end.

A deleted document cannot be used as a basis for navigation in a view or a document collection.

You cannot use the remove method on a Document object returned by the DocumentContext property.