UX Writing and Content

UX writing and content should focus on clear and concise language with familiar words and a clear text hierarchy to ensure user-friendly design.

How to sound like Genesys


Our voice

Genesys is a friendly and confident expert:

  • We are focused on the customer.
  • We are optimistic and encouraging.
  • We speak directly to the user.
  • We use clear and simple language, including only the most important details.

Our tone

The tone of Genesys is different depending on the situation, but it is always:

  • Empathetic - demonstrate that we understand the user’s needs
  • Respectful - maintain the dignity of Genesys and the user
  • Casual - friendly, approachable, and helpful
  • Thoughtful - consider the situation and the type of information you are delivering
This grid can help you identify what tone to use based on the copy your are writing. Generally, we are casual and concise, but there will be times when a more formal and detailed approach is better for providing information to the user.

This grid can help you identify what tone to use based on the copy your are writing. Generally, we are casual and concise, but there will be times when a more formal and detailed approach is better for providing information to the user.

UX writing standards


Capitalization

The use of capitalization varies based on what you’re writing and where you are writing it.

Sentence case

Capitalize the first letter of the first word and use lowercase for all other words.
Note: Capitalize user titles/roles, product names, and acronyms within the sentence, and Genesys Cloud features or product names in all writing including when they are the only words in the header.

Use sentence case for:

āœ… Tooltips
āœ… Body content
āœ… Blank states
āœ… Toast and alerts
āœ… CTAs and buttons
āœ… Form field labels
āœ… Links
āœ… Headings
āœ… Titles

Do
Three action buttons showing one primary 'Save new version,' and two secondary 'Save draft,' and 'cancel' options with words in sentence case.

Sentence case has a more casual tone.

Don't
Three action buttons showing one primary 'Save new version,' and two secondary 'Save draft,' and 'cancel' options with all words in capital case.

Capitalizing each word can sound too formal.

Do
Language settings form in sentence case.

Sentence case is easier to read.

Don't
Language settings form with each word capitalised.

Capitalizing each word is harder to read and can add unnecessary emphasis to words.

 

Title case

Capitalize all words except articles (a/an), prepositions (of, in, to, out, from ), or conjunctions with fewer than four letters (and, or, so, for).
Do not use punctuation.

Use title case for:

āœ… Genesys company and brand names
āœ… Personas
āœ… Product features and product names
āœ… Professional titles

Do
Login page with Genesys logo in title case.

Title case helps to identify official Genesys branding.

Do
Role selection panel with options in title case.

The formality of roles and professional titles is reflected by using title case.

Do
Donut chart showing branded product names in title case.

Using title case clarifies that you are referring to a specific branded product.

Do
User list displaying names, roles, and avatars with roles and names in capital case.

Professional titles are formal roles and should be capitalized.

 

All caps

Using all uppercase letters, or ā€œall caps,ā€ can reduce accessibility and be read as shouting or yelling if used inappropriately. Use all caps sparingly and with purpose.

Dos and don’ts

āœ… Use all caps for acronyms, such as accepted product and feature names on second attribution (e.g., Automatic Call Distribution (ACD) without a period between the letters).
āœ… Use all caps for names of file extensions (e.g., TIF, ZIP, or PSD files).
āœ… Reference the Resource Center glossary for Genesys-specific abbreviations and acronyms.
āš ļø If an acronym might not be known, spell it out the first time, but not for common ones like PDF, CEO, AM/PM.
āŒ Do not use all caps for emphasis.
āŒ Do not use all caps for CTAs or buttons.

 

Do
File upload area with drag-and-drop zone and button to select files with acronyms all capitalised.

Acronyms are capitalized, even when used in flow text.

Do
FAQ import form with URL option selected and input field for entering a web address with all acronyms capitalised.

Multiple acronyms within a sentence should be capitalized without a period between the letters.

 

Contractions

Use contractions for a more conversational and friendly tone.

Dos and don’ts

āœ… Be intentional with your use of contractions, too many can be difficult to read.
āŒ Do not use uncommon, old-fashioned, or colloquial contractions.
āŒ Do not use contractions for destructive actions.
āŒ Avoid contractions for pairings that end with "have", "was", "is", "has", "does", ā€œwouldā€.

Do
Messages read 'You can't edit', 'You haven't added any favorite contacts yet', and 'Sorry, I couldn't understand that...'.

Use common contractions to sound more conversational and natural.

Don't
Messages read 'You can't edit', 'You haven't added any favorite contacts yet', and 'Sorry, I couldn't understand that...'.

Contractions keep sentences from feeling out-of-touch, robotic, or overly formal.

Caution
Messages read: 'You cannot undo this action' and 'Once deleted, this article cannot be recovered'.

Sometimes "cannot" provides more emphasis than "can'tā€ when caution is needed.

DO USE

DON’T USE

āœ… can't

āœ… don't

āœ… won't

āœ… you'll

āœ… you’re

āœ… they'll

āœ… they're

āœ… we'll

āœ… we’re

āŒ y'all

āŒ ain't

āŒ should’ve

āŒ it’s

āŒ that’s

āŒ what’s

āŒ we’d

Don't
Message reads, 'Y'alls account has been disabled'.

Colloquial contractions are usually regional and difficult to translate.

Don't
Message reads: 'Your document's ready to view'.

Contractions with ā€œisā€, ā€œdoesā€, ā€œhasā€, or ā€œwasā€ can make the noun seem possessive and cause confusion.

 

Punctuation

Punctuation is important for clarity or emphasis, but not always necessary.

Dos and don’ts

āœ… Use periods for body content.

āœ… Use the Oxford comma (or serial comma) to identify the last item in a lists.

āœ… Use hyphens for date ranges and compound adjectives or descriptors.

āŒ Do not use ampersand (&) unless is it part of a branded product name.


āŒ Do not use periods for CTAs, tooltips, titles, or headers.

 

Do
FAQ import form with URL option selected and input field for entering a web address with body copy.

Body copy is casual and should be written as full sentences ending with a period to sound more conversational.

Don't
FAQ import form with URL option selected and input field for entering a web address, all text with periods.

CTAs, tooltips, titles, and headers are short phrases and do not need punctuation.

Do
Sentence case body text with a comma between acronyms.

Include a serial (or Oxford) comma to ensure clarity for the user.

Don't
Button stating 'Save & exit'.

Ampersand and other symbols can be difficult to read, challenging to translate, and confusing to the user.

Do
Text split with hyphens such as '1-4' and 'auto-update'.

Hyphens separate words to provide more accurate information and reflect date and number ranges.

 

Font styles

Font style is dependent on what content you are writing and what typeface you are using.

Dos and don’ts

āœ… UseĀ boldĀ in moderation and only for high emphasis.
āœ… UseĀ semi-boldĀ in moderation and only for low emphasis.
āœ… Reserve underline exclusively for links.
āŒ SkipĀ italicĀ and useĀ boldĀ for emphasis.

 

Do
Confirmation dialog pop-up card for deleting an article with title and important words in the body text bolded.

Use bold text sparingly and only to highlight important information.

Do
Customer interaction card showing bolded caller name, semi-bold 'member services', and regular issue type, on-hold status, and elapsed wait time.

Use semibold text sparingly and only for less important emphasis.

Do
Body text with some words underlined.

Underlined text should only be used for in-line links.

Don't
Confirmation dialog pop-up card for deleting an article with important words italicised.

Italics do not format appropriately in many fonts; avoid using italics to highlight important information or links.