Preferred Words

When writ­ing micro­copy, like CTAs or prod­uct con­tent, we want to use con­sis­tent terms so our cus­tomers don’t get confused. 

Modify

Submit

Update

See

Show

Pay

Don't use these words when you can help it.

Add/Create

Delete/Remove

Edit/Manage

Send/Share

Save

View

Do use these approved words according to the guidelines below.

Some terms, like add” and cre­ate,” are appro­pri­ate in dif­fer­ent sit­u­a­tions. Here are a few guide­lines to help you decide when you should use each word.

Add” comes into play when putting a new ele­ment into a larg­er sys­tem that already exists. Think of ath­letes on a ros­ter, events on a sched­ule, data in the break­down columns. Add is for the indi­vid­ual part.

Create” applies when build­ing a larg­er sys­tem to which oth­er ele­ments will be added, like installs, sea­sons, groups and reports. They all house addi­tion­al pieces and information.

Delete” means the ele­ment will no longer exist. It doesn’t live any­where else with­in Hudl. It’s tied direct­ly to the sys­tem a user is cur­rent­ly view­ing, and choos­ing to delete will destroy it entirely.

Remove” works when sep­a­rat­ing an ele­ment from the sys­tem in which it’s cur­rent­ly being viewed. Removing an ath­lete from the ros­ter doesn’t destroy” the ath­lete entire­ly. They’re sim­ply no longer asso­ci­at­ed with that team.

Use edit” to direct­ly change the phys­i­cal attrib­ut­es of an ele­ment so it ulti­mate­ly looks dif­fer­ent in the end. 

When users man­age” some­thing, changes aren’t phys­i­cal so much as con­tex­tu­al, like where an ele­ment lives or who’s allowed to see it.

Note: We nev­er want to swap in mod­i­fy.” It could mean either edit or man­age, which caus­es a ton of con­fu­sion with­out con­tribut­ing any­thing to the larg­er vocab.

Send” applies when the con­tent has a final des­ti­na­tion, at which point no oth­er action can be tak­en. It’s a quick one-and-done inter­ac­tion for all par­ties. (Never use sub­mit” in place of send” — it means the same thing, but it’s more formal.)

Shared” con­tent remains open and avail­able for fur­ther inter­ac­tion by both the sender and their recipient(s). This is usu­al­ly the case with high­lights, playlists and oth­er video.

This one’s sim­ple: we only ever use save.” The two words mean essen­tial­ly the same thing, so it’s best just to stick with one. 

We rec­om­mend only ever using view.” It’s user-focused, clear, and more wide­ly used than see” or show.” (“Show” is accept­able when used as an oppo­site to hide,” though. This con­ven­tion may apply when we have col­lapsi­ble con­tent in an interface.)

When in doubt, use video.” It’s the word we use in our back­end code, the word we use in prod­uct, and the word we use most when speak­ing with our customers. 

Film” is a valid alter­na­tive in mar­ket­ing or edu­ca­tion­al con­tent when we don’t want to say video” five times in a para­graph, or when it would sound strange to use video” (in American foot­ball, for exam­ple, film review” or film study” is the more com­mon phrase). 

Terms like film,” footage” or tape” are appro­pri­ate in help­ing users bridge their under­stand­ing from the old world — old tech­nolo­gies and old habits. 

Last Updated: 19 May 2020 at 3:51pm CDT