Bixby Developer Center

Guides

Capitalization and Punctuation

These guidelines apply to displayed text only.

Capitalization

Use sentence case (capitalizing only the first letter of sentences or menu items, for example) and follow standard English capitalization rules (like capitalizing proper nouns and titles). In general, this is easier to read.

  • Do: Good morning, Lisa. Happy New Year!

  • Do: Okay, I booked two tickets to San Jose, CA on Delta flight DL1968 departing Monday, October 1, 2018 at 9:00 am.

Punctuation

Use punctuation at the end of sentences unless replying with only a number (such as 65 mph or 6:00 pm).

Use periods (or the occasional exclamation point) when returning multiple search results.

  • Do: Here are 3 options.

  • Do: Here you go!

  • Do: I found 3 fancy French restaurants nearby.

Use contractions. They make the dialogue informal and less robotic sounding.

  • Do: I didn’t catch that. Could you say it again?

  • Don't: I did not catch that. Could you say it again?

Use ellipses when an action is taking place.

  • Do: Searching…

  • Do: Looking for restaurants nearby…

  • Do: Hold on while I find it…

Use symbols like currency denotations instead of spelling out the words. It’s easier to read.

  • Do: The total will be $10.91. Should I place the order?

  • Don't: The total will be ten dollars and ninety-one cents. Should I place the order?

    Don't use too many short or curt sentences with periods, which can come off as passive aggressive.

  • Do: The weather today is sunny with a 30% chance of rain and a high temperature of 78 degrees.

  • Don't: The weather today is sunny. There is a 30% chance of rain. The high temperature is 78 degrees.

Don't overuse punctuation — one exclamation point, ellipsis, or question mark (or combination of) is the limit.

  • Do: Good morning, Robbie!

  • Don't: Good morning, Robbie!!!!!

  • Do: Searching…

  • Don't: Searching……..

  • Do: Could you say that again?

  • Don't: Could you say that again?!?

Don't overwhelm with enthusiasm. Use exclamation points sparingly. A little goes a long way.

  • Do: Great, I’ve added ‘Dinner with Mom’ to your calendar.

  • Don't: Great! I’ve added ‘Dinner with Mom’ to your calendar!

Don’t use serial commas (also known as Oxford Commas) — for simplicity and to save space.

  • Do: Would you like to call, get directions or make a reservation?

  • Don't: Would you like to call, get directions, or make a reservation?

Use quotation marks when repeating user input or content.

  • Do: I found three restaurants called "The Flying Pig" in San Leandro.

  • Do: I found these images for "teacup poodles."

Emojis

A well-placed emoji makes it feel like the user is speaking to a friend. Emojis are mainly used for responses that are humorous, whimsical, entertaining, social, or light-hearted. Make sure only to use emojis in display copy (not spoken).

Avoid using any emojis that could be interpreted as inappropriate due to sexual, violent, racist, sexist, ageist, ableist, narcotic, or otherwise socially inappropriate implications.

Use emojis at the end of a sentence, in place of or after punctuation.

  • Do: Goodnight, Mayasleeping face emoji

  • Don't: Goodnight, Maya sleeping face emojicrescent moon emojiZzz emojistar emoji

  • Don't: Goodnightsleeping face emojiMaya!

Be inclusive with emoji selection. Avoid gendered and human skin-tone colored symbols.

  • Do: Let’s go to the beachsunglasses face emoji

  • Don't: Let’s go to the beach! bikini emoji [This is an example of a gendered symbol.]

  • Do: Good morningsun with face emoji

  • Don't: Good morning skin tone handraise emoji [This is an example of a skin-toned emoji.]

Don’t use an emoji in the middle of a sentence.

  • Do: It’s going to be partly cloudy in San Francisco todaysun behind cloud emoji

  • Don't: It’s going to be partly cloudy sun behind cloud emoji in San Francisco today.

Don’t use an emoji to replace a word.

  • Do: Expect scattered thunderstorms in New York today, with a high of 65 degrees thunderstorm emoji

  • Don't: It’s thunderstorm emoji in New York today with a high of 65 degrees.

Use the Samsung Emoji Graphics

Find them on the Unicode Full Emoji list website, under the "Sams" column.