Error Messages

Error messages are critical microcopy for the user experience because they happen at an emotional touchpoint: something has gone wrong and interrupted what the user's workflow.

  • Be clear and concise.
    Remove any information that's not useful. If needed, use sentence fragments.
    Do
    Session Ended

    For your security, you were signed out after 30 minutes of inactivity.

    Sign In
    Don't
    Session Expiration Notice

    Because no account activity was detected for 30 minutes, you were automatically signed out of your account. This action was taken for your security. We apologize for any inconvenience.

    Sign In
  • Be user-focused.
    Help users understand exactly what the issue is and how to resolve it. Avoid technical jargon that is not user-centric.
    Do
    The learning management system grade syncing service is temporarily unavailable. Cengage has been notified and grades will be synced after the service is restored.
    Don't
    System Error

    GATE98345

  • Provide actionable information.

    Providing actionable solutions in error messages reduces the likelihood of repeat errors. Whenever possible, include a CTA to solve the problem, redirect the user to the most relevant page in the site navigation or link to support.

    Do
    Enter date as mm/dd/yyyy
    Don't
    Date entered in the wrong format
    Do
    Your assignment must contain at least one question. Click + Add Questions to get started.
    Don't
    This assignment doesn't have any questions.
  • Avoid using "please."
    From the Microsoft Writing Style Guide, "Avoid please except in situations where the customer is asked to do something inconvenient or the application or site is to blame for the situation."

    Microsoft Writing Style Guide: please

    Do
    Enter dates as mm/dd/yyyy
    Don't
    Please enter dates as mm/dd/yyyy