Please use the form below to provide your feedback. Because your feedback is valuable to us, the information you submit in this form is recorded in our issue tracking system (JIRA), which is publicly available. You can track the status of your feedback using the ticket number displayed in the dialog once you submit the form.

Error Messages

    March 9, 2025
    + 12

    Error messages can fall into one of two types:

    1. Field validation errors: information in a form field is not formatted correctly or is missing.

    2. System errors: the application is having a problem.

    Both types of error message should follow the same general guidance.

    Say What Happened

    Clearly and concisely tell the user exactly what happened.

    For example:

    The system failed to delete a user
    The system couldn't create the user <USER_NAME>.
    An error occurred when attempting to save an item
    An error occurred when attempting to save <ITEM_NAME>.

    Say How to Fix It

    Tell the user exactly what they can do to fix what happened, or otherwise move on from the error.

    For example:

    The system failed to delete a user
    Please try to create the user again, or contact support if the issue continues.
    An error occurred when attempting to save an item
    Please try again.

    Use "please" if you’re asking the user to do something that inconveniences them. Try to reword the error message to avoid "please."

    For example, An unexpected error has occurred. Please reupload your file and try again. or An unexpected error has occurred. Reupload your file and try again.

    For very generic error messages, where we are not 100% sure what the user should do to resolve, Please try again is fine.

    Don’t use "thanks" or "thank you."

    Avoid using "sorry".

    Be Diplomatic and Avoid Blame

    State the facts diplomatically and avoid any bias.

    Do not call out the user or place any blame on their actions for an error. Do not use you or your.

    Avoid causing any worry or panic for the user, and do not make jokes to put them at ease.