Skip to main content

Errors, warnings and notifications

Learn how to write error messages, warnings, and notifications that are helpful and user-friendly. This subchapter provides strategies for communicating issues and alerts in a way that guides users towards solutions.

General rules for messaging

  • Three parts of a message: 1. title 2. explanation 3. action

  • Title: Name which information or problem may/will occur and where it comes from

  • Explanation: Give a clear reason for the (potential) error and explain it’s consequences if the user ignores it

  • Action: Add clear instructions telling the user what to do next to resolve the error

  • Do not blame the user

  • Avoid using you and your only use passive voice as an exception

  • Do not repeat your message in title and explanation

  • Do not over communicate

  • Use … to show an action is required, i.e. Fill this in…

  • Use a polite and encouraging tone

  • Keep it short

  • If detailed information is required, consider using progressive disclosure button

  • Provide specific names, locations and values of the objects involved

  • Show urgency through wording, e.g. “immediately” only if there are serious consequences from ignoring messages

Error messages

  • An error message alerts user of a problem that exists and must be addressed
  • System error: You’re offline. Check your connection and try again.
  • File error: We cannot upload this file. Try uploading again.
  • Permission error: To carry out this task, you need more permissions. Contact admin to change permissions.
  • What did you do!?
  • The email address you entered does not match the required format. Please enter your email address using the standard format.
  • You have failed to delete the device.
  • Error 404
  • Value out of range.
  • File not found.
  • Title: Input error
  • Explanation: Input error detected.
  • Action: Try again.

Warning messages

  • A warning message alerts users of a condition that may cause a problem in the future
  • Title: You have not saved all documents
  • Explanation: You have to save all documents
  • Action: (OK button)

Notifications

  • Notifications are informative and no actions are required from the user
  • Access Point 2 is connected.
  • Changes are saved automatically.
  • Access Point connection failed. Try again.
  • No rows to show.