Menu
Guides
Grammar
Formatting
Interface copy
Documentation
Glossary
Punctuation
3 min read

In a UI, the goal is to minimize distractions and guide users through clear actions and messages. The UI must be concise, functional, and often minimal in its use of punctuation.

Avoid using periods to end single sentences, particularly in labels, label description text, tooltip text, bulleted lists, dialog body text, hyperlinked text, titles, and buttons containing a sentence.

Use periods on long or complex sentences, paragraphs with multiple sentences, and any sentence followed by a link.

Do ✅Don't ❌
Invite your first sellerInvite your first seller.
Here you can invite and onboard new sellersHere you can invite and onboard new sellers.
Collection deleted successfullyCollection deleted successfully!
Total captured orders within the selected periodTotal captured orders within the selected period.
Learn moreLearn more.
Delete userDelete user?
I agree and acceptI agree and accept.

For a more objective message, avoid using commas.

Do ✅Don't ❌
[x] will also be removed from {applications} and other applications where it's being usedIf it's being used in {applications}, or others, it will also be removed from those applications
This collection has manually added products and also automatic filters in the CMSIn addition to the manually added products, this collection has automatic filters in the CMS

Use periods on multiple sentences; long or complex sentences, if it suits the context; or any sentence followed by a link.

Do ✅Don't ❌
Words related to the product. They will be used in searches. Separate the words with commas ",".Words related to the product. They will be used in searches. Separate the words with commas ","
You are using {current, number} out of {limit, number} available coupon slots. Remove some coupons to create more. Learn moreYou are using {current, number} out of {limit, number} available coupon slots. Remove some coupons to create more Learn more

Don't use exclamation or interrogation marks.

Do ✅Don't ❌
Collection deleted successfullyCollection deleted successfully!
Delete userDelete user?

Add a space before and after dashes to ensure readability and consistency in the text.

Do ✅Don't ❌
1 – 25 of 215 items1–25 of 215 items
8:00 AM – 9:00 PM8:00 AM–9:00 PM

Don't add space before and after slashes.

Do ✅Don't ❌
Filter by Name/SKUFilter by Name / SKU
Add/Remove products from collectionsAdd / Remove products from collections

Colons

Capitalize the first letter after a colon.

Do ✅Don't ❌
Autocomplete: Provides search and product suggestions based on the shopper's context.Autocomplete: provides search and product suggestions based on the shopper's context.

User interfaces

Use interrogation marks and personal pronouns only when confirming actions that are hard to undo or can't be undone.

Do ✅Don't ❌
Are you sure you want to discard all changes?
  • Want to discard all changes?
  • Are you sure you want to discard all changes
Contributors
0
Was this helpful?
Yes
No
Suggest edits (Github)
Contributors
0
On this page
GithubComunityFeedback