Menu
Feedback
Guides
Grammar
General
Punctuation
Punctuation

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 seller
  • Here you can invite and onboard new sellers
  • Collection deleted successfully
  • Total captured orders within the selected period
  • Learn more
  • Delete user
  • I agree and accept
  • Invite your first seller.
  • Here you can invite and onboard new sellers.
  • Collection deleted successfully!
  • Total captured orders within the selected period.
  • Learn more.
  • Delete user?
  • I 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 used
  • This collection has manually added products and also automatic filters in the CMS
  • If it's being used in {applications}, or others, it will also be removed from those applications
  • In 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 ",".
  • You are using {current, number} out of {limit, number} available coupon slots. Remove some coupons to create more. Learn more
  • 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 more

Don't use exclamation or interrogation marks.

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

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

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

Don't add space before and after slashes.

Do ✅Don't ❌
  • Filter by Name/SKU
  • Add/Remove products from collections
  • Filter by Name / SKU
  • Add / 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
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Was this helpful?
Yes
No
Suggest Edits (GitHub)
Contractions
« Previous
Headings and titles
Next »
Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
On this page
GithubCommunityFeedback