A guide to help anyone who writes, edits, or translates public-facing text for Stack Overflow.
Basics
Use active tense (most of the time)
You should almost always write in the active voice, particularly if the user needs to do something.
Title
Title
❌ DON'T
✅DO
“You should update your profile”
“Update your profile”
While it’s generally best to avoid the passive voice, in certain situations it helps you sound softer without adding too many words. It’s especially useful for time-sensitive messages like payment confirmations and error messages. You can also use the passive voice to avoid referring to yourself or Stack Overflow.
Title
Title
❌ DON'T
✅DO
“We cancelled your order.”
“Your order has been cancelled.”
“We’ve suspended your account.”
“Your account has been suspended.”
Use contractions
Contractions make copy sound more human. Avoid contractions that sound awkward when you say them out loud, or are not commonly used in everyday conversation.
Title
Title
❌ DON'T
✅DO
“This’ll help you get answers to your questions.”
“It’s designed to help you get answers to your questions.”
“There must’ve been an error with your order.”
“There’s an error with your order.”
Use sentence casing
Use sentence casing for all headings and calls-to-action. Proper or trademarked nouns (e.g. countries, product names) should be capitalized. If a feature or product is unique to Stack Overflow, capitalize it (Stack Overflow for Teams, Stack Overflow Jobs).
Headings
Title
Title
❌ DON'T
✅DO
Performance Overview
Performance overview
Edit Your Profile
Edit your profile
Buttons and links
Title
Title
❌ DON'T
✅DO
flag comment
Flag comment
cancel
Cancel
Features and product names
Title
Title
❌ DON'T
✅DO
Job Alerts
job alerts
Blog
blog
Profile
profile
Stack Overflow talent
Stack Overflow Talent
stack exchange
Stack Exchange
Use American spelling and standards
Use American spelling for all public-facing content. When in doubt, check the Merriam-Webster dictionary for the preferred spelling of specific terms.
Title
Title
❌ DON'T
✅DO
Recognise
Recognize
Travelled
Traveled
Colour
Color
9 April 2019
April 9, 2019
Use second person (you, your) most of the time
Refer to users as “you.” Don’t put words in their mouths with phrases that use “I” or “my.”
Title
Title
❌ DON'T
✅DO
Change my email settings
Change your email settings
When getting consent or granting permissions, refer to users as “I.” In some cases (such as getting someone to grant permissions), refer to users as “I.”
Title
Title
❌ DON'T
✅DO
You agree to the terms of service
I agree to the terms of service
When referring to Stack Overflow, use “we.” However, try to avoid inserting Stack Overflow into the content as much as possible.
Title
Title
❌ DON'T
✅DO
Stack Overflow is here to help. They’ll make changes soon.
Stack Overflow is here to help. We’ll make changes soon.
Use “their” as a singular, gender-neutral pronoun when the gender of the subject is unknown or unimportant. Avoid using gendered terms.
Title
Title
❌ DON'T
✅DO
When a new user is added, he or she will be able to edit content.
When a new user is added, they’ll be able to edit content.
We appreciate the guys and gals of Stack Overflow.
We appreciate the Stack Overflow community.
Mind your verbs and nouns
Take extra care when using “login,” and “log in.” The former is a noun while the latter is a verb. Do not use “login” as a verb. The same logic applies to “signup,” “sign up.”
Title
Title
❌ DON'T
✅DO
Login to ask a question
Log in to ask a question
Add a log in to your account
Add a login to your account
Signup to ask a question
Sign up to ask a question
Complete email sign up
Complete email signup
Punctuation
Ampersands
Don’t use ampersands (&) unless it’s part of a branded term. Spell out the word “and” instead.
Title
Title
❌ DON'T
✅DO
Update your email address & password
Update your email address and password
Stack Overflow Q and A
Stack Overflow Q&A
Apostrophes
Use apostrophes to represent omitted letters or numbers (can’t, you’re, ’90s) and to form possessives.
Title
Title
❌ DON'T
✅DO
Admins role
Admin’s role
Moderators’s tasks
Moderators’ tasks
Colons
Avoid using colons unless you’re introducing a list. If you need to use a colon in a sentence, don’t capitalize the first word after it.
Title
Title
❌ DON'T
✅DO
Your job listing was published: On January 15
Your job listing was published on January 15
Ellipses
The ellipses (…) can be used in place of a missing piece of text (most commonly to show the deletion of words from a quote). Avoid using ellipses in text. It’s appropriate to use an ellipses in input placeholder copy. Use the real single character ellipsis unicode (…) instead of three periods (...).
Title
Title
❌ DON'T
✅DO
Avoid subjective questions… stick to fact-based questions.
Avoid subjective questions. Stick to fact-based questions.
Search...
Search…
Exclamation points
Don’t use exclamation points unless something is really exciting! If you have to use one, limit yourself to one exclamation mark per page.
Title
Title
❌ DON'T
✅DO
Your email settings have been saved!
You’ve published your first job listing!
Hyphens
Use hyphens to combine two words that modify or describe the noun that follows, or join prefixes and suffixes when there are two vowels beside each other.
Use an en dash with no spaces in between (–) for a fixed range of numbers. Avoid using them in a sentence. Avoid using em dashes in microcopy.
Title
Title
❌ DON'T
✅DO
Start your free 14 day trial.
Start your free 14-day trial.
January 7 – 9
January 7–9
Get started – sign up today.
Get started. Sign up today.
Question marks
Avoid using question marks wherever possible. Reword into affirmative statements wherever you can. It’s okay to use question marks if you don’t know the result of the question (“Did you forget your email?”).
Title
Title
❌ DON'T
✅DO
Want to learn more?
Learn more
Quotation marks
Use quotation marks to define words (“Accepted answer”) or to quote text. Always use smart, curly quotes (“), not vertical, straight quotes ("). Single curly quotes (’) can be used when nested within a set of double quotes. Place punctuation marks inside quotation marks.
Title
Title
❌ DON'T
✅DO
“I meet people who use Stack Overflow every single day”, said Joel Spolsky.
“I meet people who use Stack Overflow every single day,” said Joel Spolsky.
Commas
Use the oxford comma in sentences. Don’t use a comma to separate two distinct phrases (comma splicing). Use two sentences instead.
Title
Title
❌ DON'T
✅DO
Our community is rooted in kindness, collaboration and mutual respect.
Our community is rooted in kindness, collaboration, and mutual respect.
Thanks for contacting us, we’ll be in touch soon.
Thank you for contacting us. We’ll be in touch soon.
Periods
Don’t use periods in interface copy unless it’s a full sentence or description.
Title
Title
❌ DON'T
✅DO
Sentence fragments
Complete sentences
Top-level headings and titles
Body text, descriptions, and subtitles
Buttons
Help text under text boxes (form fields)
Semicolons
Avoid using semicolons. When connecting two closely related ideas, use a comma or write two sentences.
Title
Title
❌ DON'T
✅DO
We shaved off about five minutes from last year’s survey; the survey should take about 25 minutes to complete.
We shaved off about five minutes from last year’s survey. The survey should take about 25 minutes to complete.
Components
Buttons and links
Buttons and links should be clear and predictable. People should be able to anticipate what will happen when they click or tap. Button and link text should be sentence case and action led (starting with a verb). To provide enough context, use a verb+noun format except for common actions like Save or Close.
Title
Title
❌ DON'T
✅DO
New team
Create new team
Settings
View settings
Headings and subheadings
All headings or subheadings should be concise, scannable, and sentence case. Don’t use periods at the end of headings. If a subheading is a full sentence, you may use a period.
Title
Title
❌ DON'T
✅DO
Edit Your Profile.
Edit profile
Lists
When writing lists:
Use a colon (:) to introduce an unordered list.
Use sentence case.
If any list item contains two or more sentences, punctuate all list items.
If all list items are one sentence or fragments, don’t punctuate.
Title
This element (table) isn't supported, or may require an update to be displayed. You can try to refresh the app.