Delete confirmation

Last modified by Thiago Krieck on 2026/11/18 14:13

Warning
Draft

This page is a draft. The standards on it are proposals still under discussion, so they may change and should not be treated as final yet.

The standard

Users should be asked to confirm before deleting anything that can't be restored in one click, and the question should leave no doubt about what will happen.

  • Container: Deleting a single item should be confirmed in a modal. A full page should only be used when the user has choices to make first, as in page delete with its children, backlinks and recycle bin options.
  • Title: Should name the action and the item, such as Delete user or Delete attachment.
  • Message: Should explain the consequences rather than only ask "Are you sure?", as Administration → Users does: The user {name} will be deleted and removed from all the groups that they were part of.
  • Buttons: Should be Cancel followed by a danger Delete button, never Yes / No. See Buttons.
  • Feedback: Once the item is deleted, a short notification should confirm it, such as User deleted.
  • Exceptions: A confirmation can be skipped only when the deletion is trivial to undo, such as removing a row that was never saved.

Reference example: Administration → Users or Groups → delete an entry. The modal has a specific title, a message that explains the consequences, Cancel followed by Delete, and it is announced as a dialog to screen readers. The deleted pages list follows the same model.

delete-reference-admin-delete-group.png

Delete confirmation: Administration → Groups → delete a group

Notes

  • Page delete should stay a full page, since its options don't fit in a modal.

More

Get Connected