Capitalization, punctuation, and style.
We help users accomplish tasks every day. To reflect that acitvity, we write using an active voice in our copy. Use this voice for when the user needs to do something. We only allow a passive voice in very specific scenarios. Otherwise, use an active voice in all copy you write.
To write in an active voice, you place the subject at the start of a sentence. It clearly identifies who is performing the action. This results in more direct and concise writing. It should be clear that the subject is the one doing the action.
Subject (Person / Thing) + Verb (the action) + Object (What receives the action)
Calls will be sent to voicemail.
Missed calls were sent to voicemail.
Try to catch if you're using a passive voice by looking out for the following signs:
There are times when passive voice is permissible:
Dialpad uses sentence casing for all writing except action-oriented areas (e.g., menus, buttons, links). In those situations, we use title casing.
Sentence casing aligns with our more casual brand language. There are times though when being too casual can get in the way. Wayfinding and actions are key moments within Dialpad where it’s important to be more straight-forward and formal.
When writing in sentence casing, capitalize the first word of the sentence and proper nouns only. For title casing, use the following rules:
Contractions are abbreviated words (e.g., can’t”, “aren’t”, and “you’re”). Their use helps us sound human and approachable in our writing. While you are free to use contractions in most cases, avoid using them in the following scenarios:
When writing, communicate the way our customers do. Avoid using jargon or technical terminology. If you absolutely need to use it, clearly explain the concepts.
Sentences should have a single focus. Remember that we aim for an 8th grade reading level or lower in all communication.
We use sentence vs. title casing for all writing except in the following situations:
Use sentence case for all headings. Capitalize the first word of each phrase, proper names, or trademarked nouns (i.e., branded product features).
If a product or feature isn’t unique to Dialpad, such as contact centers, teams, or offices, then don’t capitalize the name. However, if it is unique to Dialpad and we can market it as a distinct product in the market, such as Ai Scorecards or Ai Playbooks, then capitalize it.
At Dialpad we aim to respect the usage guidelines for any third-party intellectual party. Be sure to review each third party’s usage guidelines to ensure you’re using their intellectual property correctly.
For example, Salesforce does not allow their brand name to be used as part of a product offering such as “The Dialpad Salesforce app”. Instead state "Dialpad integrates with Salesforce."
Job titles should use title casing when placed close to a person’s name. When referring to a title without referencing a person, use sentence casing.
The first word following a slash shouldn’t be capitalized.
Use a bulleted list when items are related, but the sequence or priority they are listed doesn’t matter.
Introduce lists with a full sentence and a colon. Capitalize the first word of a bullet even if the bulleted item is completing a sentence. If at least one bullet point requires periods due to having multiple sentences, include punctuation on all bullets.
Avoid lists with only one bullet point.
Using Ai Playbooks provides the following benefits:
Using Ai Playbooks…
Use a numbered list when the sequence or priority order matters.
Introduce lists with a full sentence and a colon. Capitalize the first word of a bullet even if the bulleted item is completing a sentence. If at least one bullet point requires periods due to having multiple sentences, include punctuation on all bullets.
Avoid lists with only one bullet point.
To start a phone number porting request:
To start a phone number porting request, you will need to:
When space is limited, it's permissible to use horizontal action menus for the users. These menu items are often ordered based on logic, such as by popular actions or by greater to smaller options.
Menu labels follow the same “Verb” + “Noun” pattern outlined in buttons. If there’s enough context, only a verb might be necessary.
Nouns should be concise, but give users enough information that they can easily identify and select the desired item.
Time range filter
We attempt to properly localize dates, numbers, and measurements. These guidelines are for manually formatting in American English, which we use as the base before translating to other languages.
Whenever possible, fully write out dates. Dates are always represented in this order:
Weekday, Month DD, YYYY
Don’t use ordinal indicators, which are words representing position or rank in a sequential order (1st, 2nd, 3rd, etc).
Avoid writing dates numerically. We don’t localize dates and times currently, standardizing all numerical dates with American English format. Dates can be written numerically when displayed in a table or extremely tight spaces. Use the MM/DD/YY format.
Currently all time formats are formatted using the following guidelines:
We use both relative and absolute timestamps, determining what to use based on content and context.
Relative timestamps are best used in situations where specific timestamps would be tedious and unnecessary. Instead use relative timestamps when only trying to roughly communicate when something happened.
When using relative timestamps, use these formats:
| Duration | Format | Example |
|---|---|---|
| Less than 60 seconds | - | Just now |
| Less than 60 minutes | [ N ] minutes ago | 5 minutes ago |
| Less than 24 hours | [ N ] hours ago | 5 hours ago |
| Less than 48 hours | - | Yesterday |
| Less than 1 week | [ Weekday ] | Thursday |
Absolute timestamps are used in situations where specific timestamps are important and necessary such as with call times, data tables, and historical records.
When using absolute timestamps, use these formats:
| Duration | Format | Example |
|---|---|---|
| Less than 1 week | [ Weekday ] | Thursday |
| Less than 1 year | [ Weekday ], [ Mon (abbrev if necessary) ] [ Day ] | Thursday, October 12 |
| Equal to or greater than 1 year | [ Mon (abbrev if necessary) ] [ Day ], [ Year ] | May 16, 2023 |
For calls, meetings, or any other session-based interaction, we show the duration amount. Both duration groupings (“hours”, “minutes”, “seconds”) and specific duration values should be separated by non-breaking spaces.
| Available Space | Format | Example |
|---|---|---|
| Maximum space Write out the time identifiers fully when space allows. | [ NN hour(s) NN minutes ] | 1 hour 34 minutes |
| Limited space When space is somewhat limited, abbreviate the time identifiers. | [ NN hr NN min ] | 1 hr 34 min |
| Minimal space For tabular data instances, durations can be represented in absolute numerical values. Leading zeros must be present. | [ DD : HH : MM : SS ] | 01:04:05:30 |
Use common day, hour, minute, and second amounts when rendering durations (i.e., “1 hr 2 min” versus “62 min”).
When adding a duration after a time range, wrap the duration amount in paranthesis. Since the duration is secondary information to the time range, use a muted foreground color to visually diminish its importance.
Whenever possible use numerals. If the number is below 10 and not integral to the sentence, you may spell it out in full.
Use commas for numbers with four or more digits. Whenever possible, don’t truncate numbers.
Our default phone number format for designs is the North American format. In Dialpad we localize phone number formats for each country. Format consistency helps our customers quickly identify similar numbers.
Use an en dash without surrounding spaces between number ranges.
Use “to” instead of an en dash if a number range is preceded by “from” in a phrase. Use “and” if a range is preceded by “between.”
For undefined upward ranges, use “and up” or “or more.”
10
For downward ranges, be specific.
Use a nation’s proper name when referring to it as a noun.
When using a country as an adjective (such as when referring to currency), use the abbreviated form without punctuation.
Be sure to not use colloquial forms of a nation or state name, for example, America instead of the United States. Also verify if a nation commonly uses “the” before their name, for example, “the Philippines.”
Don’t use ampersands (&). They attract attention to the least important part of the sentence. Instead spell out the word “and.”
Use apostrophes to represent omitted letters or numbers:
Use apostrophes to form possessives:
Don’t use apostrophes to form possessive pronouns such as hers or his.
Avoid using colons in sentences. If you need to use one, don’t capitalize the first word after the colon unless it’s a proper noun.
Don’t use colons to introduce radio buttons or checkboxes.
Use colons to introduce bulleted lists.
Correct the following payment information to continue:
Correct the following payment information to continue.
Use the oxford comma (also known as the serial comma) in sentences. There should be a comma after every list of 3 or more items (unless you’re using a bulleted or numbered list).
Dialtone is a design system that outlines content writing guidelines, design foundations, and implementation guidance.
Dialtone is a design system that outlines content writing guidelines, design foundations and implementation guidance.
Use an ellipsis (…) in place of missing text (or portions of it) such as truncation in a recap summary or user status messages. Don’t use ellipses for placeholder copy or to trail off a sentence.
Always use the ellipsis character, not three periods.
Consider space constraints in the interface when deciding to use truncation. Identify the portion of the text strings users need the most. It’s usually the beginning or the end. If both are important, consider truncating the middle of the string.
A button with an ellipsis icon (not the same as the text) is used to expand secondary actions. It’s typically used on table rows or with horizontal action sets when space is limited.
Use an en dash with no spaces in between (–) for a fixed range of numbers.
Use an em dash only if you can’t make your message clearer by splitting it into two sentences. Use an em dash without a space on either side (—).
On Mac the keyboard shortcuts for these punctuation marks are:
Avoid using exclamation marks. Most of our copy is rarely that exciting. If you absolutely have to, limit yourself to one exclamation mark to a page.
Use hyphens to form compound modifiers, which are two words that combine to modify or describe the noun that follows.
Join prefixes and suffixes only if there are two vowels beside each other. Never use hyphens in the word "email."
Periods can often end up in places they shouldn’t or be omitted incorrectly. In general, don’t use periods in interface copy unless it’s a full sentence description.
Use periods for:
Don't use periods for:
You may use periods in bulleted, numbered, or link lists when a list item has two or more full sentences.
Avoid using question marks wherever possible. Reword sentences into affirmative statements wherever you can, but there are exceptions.
Use a question mark if you don’t know the result of a question:
Don't use question marks if:
Use quotation marks to define words (“agents”) or to quote text. Use quotation marks to indicate input that the user has provided such as a title or file name. Use this indication only when the input appears in running text.
Place commas and periods inside quotation marks. When working with literal strings like typed commands or user inputs, place the punctuation outside quotation marks.
When referring to specific UI areas, wrap the title in quotation marks.
Avoid semicolons if possible. If you need to use them, use them only to connect two closely related ideas, as long as they are both independent clauses (full sentences that could stand on their own). Also you can use semicolons to replace a comma or the word “and” between two closely related ideas.
The design team continues to grow; we’re improving daily.
The design team continues to grow; the rain is starting.
Use American spelling for all external-facing Dialpad content. When in doubt, review the Merriam-Webster dictionary for the preferred word spelling.
It’s easy to miss Canadian spelling. Switch your computer’s language settings to American English and turn spell check on. It will highlight words you might miss.
When in doubt, don’t bold copy. We use bold sparingly and only when strong emphasis is required. Don’t use bold to artificially create a heading or emphasize proper nouns, user input, or checkbox titles.
We’ve sent a confirmation email to user@domain.com.
We’ve sent a confirmation email to user@domain.com.
Always refer to users as “you.” Don’t speak for users with phrases that use “I” or “my.”
In some cases, such as when having users consent or grant permissions, you should refer to users as “I.”
Always refer to Dialpad as “we,” but avoid inserting Dialpad into content as much as possible (except when a human is taking an action, such as reviewing a request).
Grammar and mechanics documentation last updated Friday, September 4, 2026
fix/popover-modal-zindex-scope