Ready

Style

This page provides style guidelines for the Basis design system, covering topics such as using contractions, prioritizing information, addressing users, being consistent, and being concise.

Ready

Style

This page provides style guidelines for the Basis design system, covering topics such as using contractions, prioritizing information, addressing users, being consistent, and being concise.

Avoid redundancy

Avoid using the same word multiple times in a sentence or short paragraph.

Do

Do

  • No results. Try a different search.

  • No properties on this plan. Click β€œAdd properties” to get
    started.

Don't

Don't

  • No search results. Change the search term to search
    campaigns again.

  • No properties on this plan yet. To add properties, click β€œAdd
    properties above.

Use contractions

Contractions give your message a friendly tone. They can also make your sentences more concise. You don’t need to follow this rule if your sentence is more clear without a contraction. For example, β€œcannot” can be used instead of β€œcan’t” to provide emphasis on the word.

Do

Do

  • You haven’t selected any domains

  • You don’t have any brands selected

  • You cannot edit this field on a revision

Don't

Don't

  • You have not selected any domains

  • You do not have any brands selected yet

Prioritize

Prioritize your information. Begin with the main point and reveal details as necessary. If a sentence describes both an objective and the action needed to achieve that objective, start the sentence with the objective.

Do

Do

  • To RFP the vendor directly, click β€œSend” above.

  • Running on all exchanges targets a wide collection of
    inventory. Use additional targeting options to avoid
    spending your tactic's budget too fast.

Don't

Don't

  • Click the Send button above to RFP the vendor directly

  • Use additional targeting options to avoid spending your
    tactic’s budget too fast. Running on all exchanges targets a
    wide collection of inventory.

Address users in second person

Use second person when you need to speak directly to the user. In some cases, you may need to use first person to emphasize the user's ownership of content or actions. Avoid mixing second person and first person in the same sentence. Avoid using β€œwe” to describe application behavior.

Do

Do

  • You were added to Spring 2016 campaign

  • My Campaigns

  • I agree to the terms and conditions

Don't

Don't

  • View your campaigns in My Campaigns

  • We will notify vendors when the campaign is archived

  • Check if you agree to the terms and conditions

Be consistent

Use the same word or phrase to describe a particular object or action throughout the application. See the list of user actions below and the corresponding action word rules.

User Actions:
  1. Closes a non-editable window

  2. Cancels an action and closes the window without saving changes

  3. Progresses to the next step of a multi-step process

  4. Returns to the previous step of a multi-step process

  5. Allows the user to make changes

  6. Confirms the completion of a task where changes have already been saved

  7. Adds an existing object to a list

  8. Removes an object from a list

  9. Creates a new object

  10. For dropdown placeholder text and copy referring to checkboxes, add toggles, or radio buttons

  11. Opens the user's file browser and attaches the selected file

  12. Opens the user's file browser and reads the selected file

  13. Sends to a different application

  14. Downloads files from the application to the user's computer

  15. Provides the user more information or instruction

Do

Do

  1. Close

  2. Cancel

  3. Next

  4. Back

  5. Edit

  6. Done

  7. Add

  8. Remove

  9. Create

  10. Select

  11. Attach

  12. Upload

  13. Export

  14. Download

  15. Help

Don't

Don't

  1. Cancel

  2. Close

  3. Continue

  4. Previous

  5. Update, Modify, Change

  6. Close, Cancel

  7. Create, Apply

  8. Delete

  9. Add

  10. Choose, Choose [field]

  11. Upload

  12. Attach

  13. Send

  14. Export

  15. User Guide

Write in present tense

Avoid using future tense to describe actions and application behavior. One exception is when the action has not happened yet.

Do

Do

  • Changes saved

  • Proposal sent

  • Vendors will be notified

Don't

Don't

  • Changes will be saved

  • Proposal will be sent

Be specific

Be specific and reinforce the subject or action.

Do

Do

  • Save changes?

  • Send RFP

  • Create Campaign (as button label)

  • No messages

Don't

Don't

  • Are you sure?

  • β€œYes” or β€œNo” as button labels

  • Create New (as button label)

  • Nothing here yet

Write simply and avoid jargon

Use language that’s simple and easy to understand. Don’t provide more information than necessary. Avoid jargon such as technical terms and names invented to describe the UI.

Do

Do

  • To link delivery sources, click β€œMap Delivery.”

  • Primary conversion metrics will be shown for Groups and
    Campaigns

  • Once deactivated, this property cannot be added to new
    plans

Don't

Don't

  • Open the mapping panel to associate delivery sources to line
    items.

  • Setting a primary pixel will display additional metrics for the
    selected pixel on all Group and Campaign screens

  • Once deactivated, users will be notified of the details
    provided below and will not be able to add this property to
    new plans

Be concise

Write in short, scannable sentences. Avoid unnecessary modifiers.

Do

Do

  • Changes saved

  • Create property

  • You are in support mode

  • No results

  • Select at least one ad before linking campaigns

Don't

Don't

  • Your changes have been saved successfully

  • Create new property

  • You are currently in support mode

  • No results found for your search

  • Please check at least one ad before attempting to link
    campaigns

Need more guidance?

Suggest an addition or an edit.

Need more guidance?

Suggest an addition or an edit.

Β© 2025 Basis Technologies
Β© 2025 Basis Technologies
Β© 2025 Basis Technologies