Menu
Feedback
Guides
Interface copy
General
Messages
Messages

Messages consist of up to two sentences to communicate the system's current state and provide feedback on user actions. This pattern is commonly found in components like Inputs or Alerts.

General

Keep it as short as possible while still being descriptive enough. Also, remember there’s a 240-character limit per message.

Do ✅Don't ❌
  • Provider couldn't be saved due to a technical issue
  • Check this option
  • Select at least one option
  • Products couldn't be imported because the CSV file is invalid
  • We faced an unexpected issue while attempting to save the provider. There might be several reasons for this, such as server downtime or network errors
  • Check this
  • Select at least one
  • Something went wrong

Don't use technical language.

Do ✅Don't ❌
Invoice couldn't be sent due to a technical issueError 298dx9283 prevented the invoice from being sent

Reuse messages (or their structure) whenever possible.

Do ✅Don't ❌
  • Collection exported successfully
  • Provider couldn't be saved due to a technical issue
  • Enter this information
  • Check this option
  • Select at least one option
  • The collection was successfully exported.
  • A technical issue prevented the provider from being saved
  • This field is required
  • This option needs to be checked
  • At least one option needs to be selected

Don't use personal pronouns.

Do ✅Don't ❌
  • Account created successfully
  • Double-check the password
  • Your account was successfully created
  • You entered the wrong password.

Use an objective and neutral tone.

Do ✅Don't ❌
  • Invoice couldn't be sent due to a technical issue
  • Products couldn't be imported because the CSV file is invalid
  • Account created successfully
  • Log in to your Admin
  • Double-check the password
  • Enter this information
  • Oops, something went wrong, and the invoice could not be sent
  • Please upload a valid CSV file
  • Account successfully created!
  • Hello. Log in to your Admin
  • Unfortunately, the password is incorrect
  • Please enter this information

Use common contractions.

Do ✅Don't ❌
Provider couldn't be saved due to a technical issueProvider could not be saved because of a technical issue

Use punctuation only when a larger message is extremely necessary.

Do ✅Don't ❌
  • The store is being edited live. Changes will have immediate effect.
  • File couldn't be processed because its size is larger than 10MB
  • Collection deleted successfully
  • Double-check the password
  • Upload an image up to 5 MB
  • The store is being edited live and changes will have immediate effect.
  • Sorry, your file is too large. To avoid errors, try files under 10 MB.
  • Collection deleted successfully!
  • The password is incorrect, please try again.
  • This file is too large, please upload an image with 5MB at most.

Use sentence case, but capitalize proper nouns.

Do ✅Don't ❌
  • Collection exported successfully
  • Notifying Intelligent Search indexer
  • Collection Exported Successfully
  • Notifying intelligent search indexer

Specific

For the error texts in a form field, start with an imperative verb.

Do ✅Don't ❌
  • Complete this field
  • Check this option
  • Select at least one option
  • This field is required
  • This option needs to be checked
  • At least one option needs to be selected

In modals that confirm actions, personal pronouns, and question marks can be used.

Do ✅Don't ❌
This action can’t be undone. Are you sure you want to delete this product?Do you want to delete this product? This can't be undone.

For consistency, place the adverb “successfully” at the end of the phrase.

Do ✅Don't ❌
  • Order placed successfully
  • Collection exported successfully.
  • Your order was successfully placed
  • The collection was successfully exported
Contributors
1
Photo of the contributor
+ 1 contributors
Was this helpful?
Yes
No
Suggest Edits (GitHub)
Descriptions
« Previous
Placeholder texts
Next »
Contributors
1
Photo of the contributor
+ 1 contributors
On this page
GithubCommunityFeedback