Word choices

Wondering whether to “add” or “create” something? Or when to say “remove,” “delete,” or “disconnect”? This section helps you choose the right word for the right moment—so your content stays consistent, clear, and user-friendly.

Add vs. Create

  • Use add for something that already exists—inside or outside the Emplifi platform
    • Add a profile
    • Add an existing user
  • Use create when making something from scratch
    • Create a new label
    • Create a new post

Agent, Client, Customer, User

Role

Definition

Agent

A real person using Emplifi products to assist others (e.g. in Care or Community).

Note: Sometimes, you may come across the term admin for agents, but we want to avoid this. Use agent whenever relevant.

Supervisor

Manages agents and oversees activity.

Client

Emplifi’s paying customer—the organization that purchased the platform. Internal use only.

Customer

A person who interacts with our clients via Emplifi—for example, buying products via Live Advisor or reaching out to support via Care or Community.

Depending on the product context, the term "customer" may be interchangeable with “user”.

User

1. Someone from a social platform. For example, “Tag Instagram users in the image.”

2. Someone from our client’s organization using Emplifi. For example, “Add new Emplifi users in Settings”.

Apply vs. Add vs. Assign

⚠️ This is tricky inside the platform and needs to be evaluated and probably edited in the Label section insides settings

Apply

Apply label to content, apply label to label group, apply a label to profile

Add

Add a user to label

Assign

Assign a label to a group, assign a profile to label, assign a profile to a group

To Add profile label means to create a profile label (or content label or a label group)

Edit or Manage

Use ​edit when the user directly changes the physical attributes of an element so that it in the end looks different.

When users ​manage something, the changes are rather contextual than physical, like where an element lives or who’s allowed to see it.

Source: Hudl

Remove or Delete or Disconnect

In most cases, you'll be considering remove or delete. In some exceptional cases, there might be some other words to choose from.

Remove or Delete

When the removal is permanent and can't be reversed, we use delete.

When removing a social profile, we use remove. The user is removing it only from our platform, and they can add it again if they want.

Users

When the user is about to remove another user (or another word for such) from the platform, we say Remove user. We never delete users.

However, try to avoid such combinations whenever possible.

❌ The author of this query set was removed from the platform.

✅ The author of this query set is no longer a user of the platform.

Disconnect

To be as clear as possible, when removing data sources, we disconnect data connections.

Do

Don’t

Caution

View or See or Show

Use view whenever possible.

Show is acceptable when used as an opposite to hide.

Use see in general, conversational descriptions without a specific call to action.

View

Use view whenever possible. This way you’re encouraging the marketer to go to a specific page or section for more details, or to reveal more information.

Use view in buttons, calls to action, and link text. It’s user-focused, clear, and more widely used than ​“see” or ​“show.”

See

Use the verb “see” in more general, conversational descriptions without a specific call to action.

Show

Show is acceptable when used as an opposite to ​hide. This convention may apply for example when we have collapsible content in an interface or for showing done messages.

Examples

Show done messages

View the post on Facebook (View on Facebook)

As you can see…

Source: Polaris and Hudl

 

Log in versus login, log out versus logout, break down versus breakdown, etc.

To log in, log out is a phrasal verb, login, logout is an adjective.

To break down is a verb describing an action that leads to a breakdown, which is a noun.

Examples

You'll need login credentials to log in to the app.

You can break data down by profile or language. The profile breakdown is only available in combination with the language breakdown.

Sorry, please, unfortunately, and the others

Do not overuse words such as sorry, please and unfortunately. Only use them when the situation is really complicated or requires extra effort from the user.

Compare:

Please enter your name –> Enter your name (as an empty input error message)

Facebook does not allow third-party apps, like Emplifi, to display this content type. You can still check it directly on Facebook.

We're having unexpected issues. Please come back in an hour and if the issue continues, contact our support.

Do

Don’t

Extra resource on saying sorry: https://medium.com/honestbee-design/why-not-to-say-sorry-in-error-and-info-messages-11151047f01a