About this guide
The 1Password Style Guide provides helpful guidelines for all written communication, so you can be more confident and consistent when writing about 1Password. It’s your guide to writing style, usage, and 1Password terminology, so we’re all writing in one voice: the 1Password voice.
In general, follow the style and usage rules in:
- Apple Style Guide (HTML; Apple Books)
- The New Oxford American Dictionary (included in the Dictionary app on your Mac; Amazon)
Where we explicitly contradict these resources, follow our advice instead. If the contradiction seems unintentional, please bring it to our attention.
About this version
The November 2020 edition of the 1Password Style Guide is the first public release. It’s also a major update to the guide.
This edition introduces a Fundamentals section with guidance on general language use. This section includes new information on using colloquialisms and phrasal verbs, company and product names, database jargon, -ing words, links, and quotation marks. It also adds Linux to the platform list.
This edition also includes new entries in Terminology and usage for 1Password account password, countries and regions (EU, UK, U.S.), Privacy Cards, and via. There are lightly updated entries for member, permission, and two-factor authentication. Terms that previously appeared in the database jargon section have been moved to Terminology and usage (add, remove, begin, complete, connect, delete, display, enable, disable, load, modify, new, existing, read, success, fail, update).
Make a suggestion
If you have a suggestion to improve the 1Password Style Guide, contact firstname.lastname@example.org. If you work at 1Password, you can file a style guide issue.
Don’t use internal abbreviations in user materials. For example: 1P, AG, AGK, AKB, B5, B5Web, B5X, CS, MAS, NM, OP, OPA, OPI, OPM, OPV, OPW, OPX.
Avoid Latin abbreviations like e.g., i.e., etc., and others. Write them out: for example, as in, and more.
Don’t use capitalization for emphasis or every time there is a special term. Some terms are capitalized (Emergency Kit, Secret Key); most are not (vault, team, diagnostics report). Follow capitalization used in “Terminology and usage”.
Colloquialisms and phrasal verbs
Avoid colloquial phrases. They’re harder for non-native speakers to understand and harder to translate.
Correct: Contact 1Password Support whenever you need help.
Incorrect: Reach out to 1Password Support whenever you need help.
Correct: Contact us on Twitter at @1Password.
Incorrect: Get in touch with us on Twitter at @1Password.
Avoid phrasal verbs unless the alternative seems overly formal.
Correct: Visit the 1Password Support site for help.
Incorrect: Check out the 1Password Support site for help.
Use a serial comma in a list of three or more items.
Correct: You can use 1Password to save passwords, fill addresses, and more.
Incorrect: You can use 1Password to save passwords, fill addresses and more.
Company and product names
Omit punctuation. Use title-style capitalization for names in all caps or all lowercase. Don’t start a sentence with a lowercase letter.
Correct: Eero, Yahoo, Hey
Incorrect: eero, Yahoo!, HEY
Use contractions. Don’t form contractions from nouns or proper nouns.
Correct: After you’ve installed the extension, you’ll see the 1Password button in your browser.
Incorrect: After you have installed the extension, you will see the 1Password button in your browser.
Negative contractions: Don’t use when warning about destructive actions, like deleting data.
Correct: Your items will be deleted. You cannot undo this action.
Incorrect: Your items will be deleted. You can’t undo this action.
1Password is a CRUD app. Underneath the fancy UI, it’s a database with a set of actions that can be performed on entries. These actions are known as “CRUD verbs” (create, read, update, delete, add, purge, modify, retrieve, search, filter, sort, and so on).
Other CRUD apps include address books, note-taking apps, and email. Sometimes CRUD language is unavoidable, but usually it can be replaced by more relevant metaphors or phrases:
In your email app, you don’t create a new message item; instead, you compose a message. You don’t purge all entries; instead, you clear your inbox.
Whenever possible, avoid CRUD jargon in both the 1Password apps and documentation. See also add, remove, begin, complete, connect, delete, display, enable, disable, load, modify, new, existing, read, success, fail, update.
Headers and section titles
Use sentence-style capitalization for headers and section titles.
Keep annotations to a minimum. Where they’re necessary, using orange contrasts with 1Password blue, doesn’t have negative connotations of red, and works well for many people who are color blind.
Avoid words that end with -ing. They can be ambiguous and difficult to translate. Whenever possible prefer a strong verb or more descriptive phrase. OK to use when necessary for progressive tenses or -ing words with no alternative.
Preferable: Sign in on a new device
Avoid: Signing in on a new device
Correct: To stop sharing an item, remove it from the Shared vault.
Use descriptive link text. If the link text is a complete sentence, include terminal punctuation.
[Upgrade to 1Password Business.](/business/)
Get started with [1Password Business](/business/).
[Click here](/business/) to learn more about 1Password Business.
- 1Password Support articles: Whenever possible, use the titles of support articles as the link text, especially when listing links.
Use numbered lists for steps that should be followed in order.
- Unlock 1Password.
- Choose 1Password > Preferences, then click Security.
- Select “Lock when main window is closed”.
Use bulleted lists to express information in parallel, or to present steps that can be followed in any order. Bulleted lists should usually be introduced with a sentence and a colon.
Before you begin:
- Make sure you have the latest version of 1Password.
- Check that you are connected to the Internet.
Both kinds of lists should use parallel structure for every item.
Don’t refer to an operating system when you can refer to the computer or device instead.
Correct: You can use 1Password on your Mac or Windows PC.
Incorrect: You can use 1Password on macOS and Windows.
Acceptable: 1Password works best on the latest version of macOS.
When listing platforms, use this order: Mac, iOS, Windows, Android, Linux, Chrome OS.
Put punctuation marks outside quotation marks. OK to include original punctuation inside quotation marks. Include ellipses inside quotation marks when quoting a source.
Correct: Click “Get started”, then click “Sign up”.
Incorrect: Click “Get started,” then click “Sign up.”
User interface: Use quotation marks around user interface elements that use sentence-style capitalization. Don’t use quotation marks for elements that appear in title-style capitalization. If the element uses all caps or all lowercase, use title-style capitalization.
Choose File > New Item.
Click “New item”.
Use U.S. English for written materials, including the apps, blog, documentation, marketing materials, social media posts, and website.
Use the English spelling rules you’re most comfortable with for personal communication, including the 1Password Support Community, email, and social media replies.
Tone and voice
Because we’re warm, friendly people, we want our writing to express that. An informal tone can often help close a sale or put worried customers at ease. A formal tone can have the opposite effect:
Too formal: As per your request, attached please find the document that describes the security of 1Password. I await your response.
At the same time, we should respect our customers by reducing the amount of time they have to spend thinking about our copy. The words we use should communicate clearly without calling too much attention to themselves. Too much emotion can be as off-putting as corporate speak:
Too emotional: It’s so awesome that you care about security! Just click here to check out our white paper. You’ll love it! 😘
Good writing is warm and informal without relying on emotional words or extraneous politeness:
Just right: Thanks for getting back to me. Here’s the 1Password Security Design white paper you asked for. Let me know what you think.
Don’t imply that a task is easy or trivial. It may be easy for you, but you don’t necessarily know the skill level of the user. Omit words like just and simply.
Correct: Sync with Dropbox.
Incorrect: Just sync with Dropbox.
Incorrect: Simply sync with Dropbox.
Emotionally neutral language
Use emotionally neutral language when possible. Don’t try to make someone feel an emotion, especially if that emotion is trying to cover up something we’re embarrassed about or think they won’t like. Let people decide for themselves how they feel.
Correct: Click Subscribe.
Incorrect: Click the “Yes, I’d love to subscribe” button.
Don’t use exclamation points in lieu of good writing. If the sentence is exciting, the content will speak for itself.
Correct: 1Password is up to date.
Incorrect: 1Password is up to date!
First person plural pronouns
Don’t use we, our, ours when people are not involved, like an in-app message. Use only when speaking for the entire company, not just yourself.
Correct: The password isn’t in the database.
Incorrect: We didn’t find this password in the database.
Correct: I’ll resolve the problem for you.
Incorrect: We’ll resolve the problem for you.
Avoid negative words like unfortunately, sadly, negligent.
Correct: You can upgrade to the latest version to get all these features…
Incorrect: It would be negligent of me not to recommend an upgrade.
Also avoid phrases that can be interpreted as condescending like of course, obviously, clearly. Words will be read in the reader’s current mental and emotional state (which may not be good), so frame them positively.
Correct: You’re exactly right! You can use 1Password on all your devices with a membership.
Incorrect: Of course you can use 1Password on all your devices with a membership.
Incorrect: Obviously you’ll need your Secret Key to sign in on your new Mac.
Don’t place blame on the user for negative outcomes. Even if you think there is no way something “just happened”, someone else could have been using their computer. Passive voice is often ideal in these situations.
Correct: There are multiple copies of 1Password on your Mac.
Incorrect: You downloaded multiple copies of 1Password.
Correct: Over 50 conflicts were found in the file.
Incorrect: You created over 50 conflicts in the file.
Don’t use please when it can be omitted. It’s more polite to write clearly than to put please at the beginning of every instruction.
Correct: Follow the steps below.
Incorrect: Please follow the steps below.
Don’t bring up problems that haven’t happened yet or apologize in advance.
Correct: The supported Markdown syntax makes it easy to add style and structure to your notes. We look forward to hearing what you think.
Incorrect: For security reasons, 1Password doesn’t support every feature of Markdown, but we hope you’ll like the features that are supported.
Wants and needs
Don’t tell people what they want, need, should, or could do.
Correct: Sign in to your account on 1Password.com.
Incorrect: You’ll want to sign in to your account on 1Password.com.
Incorrect: You should sign in to your account on 1Password.com
Terminology and usage
in or on: Use in the 1Password app, in your 1Password account, or in 1Password; use on 1Password.com.
Your data is stored in your 1Password account. You can access it on 1Password.com or in the 1Password apps.
1Password’s: Don’t use.
Correct: Open and unlock 1Password, then tap Settings > Security.
Incorrect: Check 1Password’s security settings.
1Password.com (n.) The 1Password website and the web interface for 1Password. Don’t use when you mean 1Password account or 1Password membership. Don’t use as an adjective (as in, 1Password.com account, 1Password.com membership, 1Password.com subscription). See also 1Password account, 1Password apps, 1Password membership.
Correct: Visit 1Password.com for pricing information.
Correct: Sign in to your account on 1Password.com.
Correct: All your information is stored in your 1Password account.
Incorrect: All your information is stored on 1Password.com.
service: The name of the service is 1Password.
Correct: Sign up for 1Password.
Incorrect: Sign up for 1Password.com.
Incorrect: Sign up for a 1Password.com account.
regions: Because the sign-in page on 1Password.com allows people to choose a different region, 1Password.com works in most contexts. When 1Password.com might confuse customers with accounts in other regions, it’s OK to use web. Avoid referring to specific regions (1Password.ca, 1Password.eu) unless the distinction is necessary.
Preferable: Sign in to your account on 1Password.com.
Acceptable: Sign in to your 1Password account on the web.
1Password account The account a person uses to sign in to 1Password. Don’t use when you mean 1Password membership, which is a way to purchase and use 1Password. Don’t use when you mean family account, team account, or business account. See also 1Password membership, individual account.
Correct: Sign in to your 1Password account.
Incorrect: Invite people to your 1Password account.
create a 1Password account: Prefer alternatives to avoid giving the impression accounts are free. For example, sign up for 1Password, or start your 1Password membership.
use: Customers use 1Password and have a 1Password account.
1Password account password Note capitalization. Use password if the context is clear. OK to use password for your 1Password account or account password. Not Account Password. Prefer describing the behavior.
Correct: Sign in to your account on 1Password.com.
Avoid: Sign in to your account on 1Password.com using your account password.
Correct: Open and unlock 1Password.
Avoid: Open 1Password and enter your 1Password account password.
Correct: Enforce stricter requirements to make sure everyone in your team has a strong account password.
Incorrect: Enforce stricter requirements to make sure everyone in your team has a strong Master Password.
1Password apps The full names are 1Password for Mac, 1Password for iOS, 1Password for Windows, 1Password for Android, 1Password for Linux, and 1Password X. Omit the platform unless the distinction is necessary. See also 1Password.com.
version numbers: Leave out unless necessary. See also version.
1Password 6 for Mac is the latest version.
the Mac app, the iOS app, the Windows app, the Android app, _the Linux app:_ OK to use after the names have been spelled out.
Mac, iOS, Windows, Android, Linux: OK to use in documentation if there is plenty of context.
On Mac, press Command-N. On Windows, press Ctrl + N.
native apps, client apps: Use 1Password app if you need to make the distinction from 1Password.com. Don’t use native as a selling point when referring to the design of the 1Password apps.
Correct: You can use the 1Password app or sign in to your account on 1Password.com.
Correct: 1Password is a beautiful app designed to feel right at home on your Mac.
Incorrect: 1Password is a native Mac app.
web app: Use 1Password.com.
business account, team account: Not teams account. Contrast with family account. Use when referring to actions that affect every team member. See usage note at team subentry below. Don’t use when referring to the accounts used by individual team members; prefer describing the account.
Correct: You can only delete the team account if you’re a team owner.
Correct: You can delete a team member’s account if you’re a team owner.
Incorrect: You can delete someone’s team account if you’re a team owner.
Correct: Sign in to the 1Password account you use at work.
Incorrect: Sign in to your team account.
Correct: You might have multiple accounts because you’re already using 1Password at home and were invited to a team at work.
Correct: See all your items from your work and personal accounts at the same time.
business: Don’t use when you mean business account.
company, employees: OK to use when referring exclusively to 1Password Business, especially in marketing materials.
1Password Business helps your company stay safe and secure.
Every employee using 1Password Business gets a free 1Password Families membership.
team: Can refer to people who belong to a team or business account or the account itself. Prefer team to team or business account.
team member: Not member or business member.
membership: Use 1Password Teams membership or 1Password Business membership. Not team(s) membership or business(es) membership.
sign up: Customers sign up for 1Password Teams or 1Password Business. OK to use create a team account or create a business account.
join: Additional team members join a team. They don’t join 1Password Teams, join 1Password Business, join a 1Password Teams membership, or join a 1Password Business membership.
1Password command-line tool Note capitalization and hyphenation. OK to use the tool after first occurrence. Not CLI. Use command line when describing where you can use it. Don’t use
op as the name of the tool.
op --helpto get help using the 1Password command-line tool.
1Password extension Singular. Note capitalization. Not browser extension. Don’t use when you mean 1Password X. OK to use the extension after first occurrence.
Correct: Install the 1Password extension in Safari.
Incorrect: Install the browser extension.
app extension, iOS extension: Don’t use. There is only one 1Password extension. It works in browsers and supported iOS apps.
Describing features: Avoid using extension when you can attribute a feature to 1Password.
Correct: 1Password fills usernames and passwords in your browser.
Incorrect: The extension fills usernames and passwords in your browser.
Using the extension: Don’t use extension when telling people what to click. Describe the action the user takes.
Correct: Click the 1Password button in your browser.
Correct: Tap the Share icon, then tap 1Password.
Incorrect: Open the 1Password extension in your browser.
family account: Not families account. Contrast with team account and business account. Use when referring to actions that affect every family member. See usage note at family subentry below. Don’t use when referring to the accounts used by individual family members; prefer describing the account.
Correct: You can only delete the family account if you’re a family organizer.
Correct: You can delete a family member’s account if you’re a family organizer.
Incorrect: You can delete someone’s family account if you’re a family organizer.
Correct: Sign in to the 1Password account you use at home.
Incorrect: Sign in to your family account.
Correct: You might have multiple accounts because you’re already using 1Password at home and were invited to a team at work.
Correct: See all your items from your work and personal accounts at the same time.
family: Don’t use when you mean family account. Use only when the sentence would still be appropriate if you replaced (a, the, your) family with someone’s name.
Correct: Invite people to your family account.
Correct: Invite your family.
Incorrect: Delete your family. (You wouldn’t say Delete Mitch.)
Incorrect: Upgrade to a family. (You wouldn’t say Upgrade to Khad.)
family member: Not member.
membership: Use 1Password Families membership. Not family membership or families membership.
Correct: Upgrade to a 1Password Families membership.
Correct: Upgrade to 1Password Families.
Incorrect: Upgrade to a family membership.
sign up: Customers sign up for 1Password Families. OK to use create a family account.
join: Additional family members join a family account. They don’t join 1Password Families or join a 1Password Families membership.
1Password Gift Card Gift card for 1Password memberships. Capitalize the full product name, otherwise use gift card or card.
When you redeem a 1Password Gift Card, the amount on the card is added to your 1Password membership as a credit.
redeem: Customers redeem gift cards. They don’t apply them.
gift card code: The code used to redeem a gift card.
1Password Interchange Format Note capitalization. Not 1Password Interchange File. OK to shorten to 1PIF after first occurrence.
.1pif: OK to use parenthetically to clarify the filename extension of the format generally. Use 1PIF file when talking about a specific file or folder on disk.
Acceptable: You can export to 1Password Interchange Format (.1pif).
Correct: Select the 1PIF file you exported to your Desktop earlier.
Incorrect: Select the .1pif file you exported to your Desktop earlier.
1Password membership A way to purchase and use 1Password. Contrast with standalone license. Don’t use when you mean 1Password account, which is the account a person signs in to. See also 1Password account, subscription.
Correct: Purchase your 1Password membership today with a monthly or annual subscription.
Correct: There are two different ways to purchase 1Password: a 1Password membership and a standalone license.
Incorrect: There are two different ways to purchase 1Password: a 1Password account and a standalone license.
- trial: Avoid. Rephrase as try free for 30 days.
1Password mini Note capitalization. Use when referring to the icon in the menu bar on Mac or notification area on Windows. Don’t use when referring to the 1Password extension in a browser. Don’t shorten to mini. See also 1Password extension.
1Password SCIM bridge Note capitalization. OK to use SCIM bridge after first occurrence.
website: Use the 1Password Support website. OK to use 1Password Support if the context is clear, like on the website itself. Not AwesomeKB, ShadowKB, or KB^2. Don’t use knowledgebase, user guide, or customer support site.
Browse or search the 1Password Support website (support.1password.com) to learn about 1Password.
article, video: OK to use support article or support video. Don’t use troubleshooting article, tutorial, or guide.
contact: Use 1Password Support when describing how to contact 1Password.
Correct: Contact 1Password Support for help moving from another password manager.
Incorrect: Contact our customer support team for help moving from another password manager.
1Password Support Community Singular. Use the definite article, not a personal pronoun: the 1Password Support Community. OK to shorten to the community after first occurrence if the context is clear. Not support community or forum. People can visit, join, and ask the community; share feedback or start a conversation with the community; and get help from the community. Use categories when referring to the different sections. See also 1Password Support.
Correct: Visit the 1Password Support Community.
Incorrect: Visit the forum.
Correct: Share your feedback in the Mac Beta category.
Incorrect: Share your feedback in the Mac Beta community.
1Password X Although 1Password X is technically a browser extension, don’t refer to it as the extension or the 1Password extension. Always use the full product name or 1Password when the context is clear. See also 1Password extension, Desktop App Integration.
inline menu: Don’t use in user materials. Describe what the user sees or does.
You’ll see the 1Password icon in forms where you need to sign in.
1Password pop-up: Note capitalization. OK to use the pop-up after first occurrence. Prefer describing the action the user takes.
Preferable: Click the 1Password button in your toolbar and choose Password Generator.
Acceptable: To search, open the pop-up and start typing.
Correct: Enter your account details to sign in.
Correct: Scan your Setup Code, then enter your 1Password account password.
Incorrect: Scan your account details.
account menu, team menu, family menu Don’t use. Instead, describe the action the user takes.
Click your account name in the top right and choose My Profile.
add, remove These terms can mean many different things in many different contexts. (When you “add a credit card” are you saving a Credit Card item in 1Password, or are you starting your subscription?) Find more specific and meaningful alternatives whenever possible.
add or remove an account: For the first account: sign in, sign out. For additional accounts: sign in to another account.
add or remove a team member: Use invite, remove.
add someone to a vault, remove someone from a vault: Use share a vault, stop sharing.
add or remove an administrator: Use make, promote, designate, or change role.
add or remove an item: Use create, move to Trash in the apps, and save in the extension. Use move or copy when moving an item from one vault to another.
add or remove a device: Use set up another device, sign in on another device, sign out, get 1Password for your other devices, deauthorize.
add or remove a credit card: Use start your subscription, cancel your subscription.
administrator OK to use when it’s clear you’re referring to members of the Administrators group. Don’t shorten to admin.
Admin Console Don’t use. Describe the action the user takes.
Correct: To manage your team, sign in to your account on 1Password.com.
Incorrect: Manage your team in the Admin Console.
Advanced Protection Capitalize. OK to use 1Password Advanced Protection in marketing materials.
Use Advanced Protection in 1Password Business.
features: Don’t use as proper nouns. Describe the behavior.
Correct: You can create firewall rules or require modern apps.
Incorrect: You can create Firewall Rules or require Modern Apps.
Correct: 1Password is the coolest company in the world.
Avoid: AgileBits is the coolest company in the world.
Correct: 1Password now has Travel Mode.
Avoid: AgileBits is introducing Travel Mode to 1Password.
Incorrect: 1Password is introducing Travel Mode to 1Password.
- employee, staff: Don’t use. Use team member instead.
Agile Keychain format Note capitalization. An open format used by 1Password, introduced in 2011. Avoid using Agile Keychain as a standalone noun. Don’t use when you mean vault. See also OPVault format.
Agile Keychain file, Agile Keychain folder: OK on Mac and Windows, respectively.
.agilekeychain: Use if you’re talking about a specific file or folder on disk, like 1Password.agilekeychain. Not AgileKeychain.
AgileBits Store version, website version: Don’t use.
Not an app store: 1Password isn’t released to the AgileBits Store; it’s available on our website.
Correct: If you installed 1Password from our website.
Incorrect: If you’re using the AgileBits website version.
Incorrect: 1Password 6.4 has been released to the Web Store.
all, all of Use all with nouns and possessive pronouns; use all of with pronouns and possessive nouns.
All the apps are included.
All of them are included.
All her passwords are strong.
All of Lisa’s passwords are strong.
All Vaults Capitalize. Don’t use an article. Don’t use as an adjective.
Correct: Switch to All Vaults to see all your items at once.
Incorrect: Switch to the All Vaults view to see all your items at once.
around Don’t use when you mean on the subject of; use about.
Correct: The blog has the latest news about 1Password.
Incorrect: The blog has the latest news around 1Password.
as Don’t use when you mean because.
Correct: You can recover accounts because you’re a family organizer.
Incorrect: You can recover accounts as you’re a family organizer.
Autofill, AutoFill The Mac and iOS feature is AutoFill; the Windows and Android feature is Autofill. Use Autofill on platforms where there is no convention to follow. Use autofill for the verb. Use the feature name for button labels.
With 1Password, you can autofill passwords, addresses, and credit cards.
To fill your username and password on your iPhone or iPad, tap AutoFill.
To fill your username and password on your Android device, tap Autofill.
To fill your username and password on your Linux workstation, click Autofill.
autosave (n., adj.) OK to use in some contexts like autosave settings. Prefer describing the behavior. Don’t use as a verb.
Correct: 1Password asks to save your passwords.
Incorrect: 1Password autosaves your passwords.
autosubmit Don’t use. Use sign in automatically.
auto-lock (n., adj.) OK to use in some contexts like auto-lock settings. Prefer describing the behavior. Don’t use as a verb.
Correct: 1Password locks automatically after 5 minutes.
Incorrect: 1Password auto-locks after 5 minutes.
Auto-Type (n., adj.) Note capitalization and hyphenation. A feature that lets 1Password 4 for Windows fill in other apps. Don’t use as a verb.
Correct: 1Password can fill passwords into other windows when Auto-Type is turned on.
Incorrect: 1Password can auto-type passwords into other windows.
avatar Don’t use. Use profile picture for individuals, family or team members, family picture for family accounts, and team logo for teams.
Back Office Two words. Note capitalization.
begin, complete Avoid when referring to actions that have multiple steps. If necessary, use start and finish.
billing Use only to refer to payment or payment details. For example, paying with a credit card or a gift card, paying monthly or annually. When payment isn’t the focus, rephrase in terms of the subscription. See also subscription.
Correct: You can choose monthly or annual billing.
Acceptable: Manage billing on 1Password.com.
Preferable: Manage your subscription on 1Password.com.
Correct: All your information is available in your 1Password account.
Correct: All your information is synced with iCloud.
Incorrect: All your information is sent to the cloud.
Preferable: Visit 1Password.com on your Mac or PC to finish signing up.
Acceptable: Visit 1Password.com on your computer to finish signing up.
Incorrect: Visit 1Password.com on your desktop to finish signing up.
connect Don’t use connect when referring to communication between 1Password, 1Password mini, or the 1Password extension.
Correct: The 1Password extension was unable to communicate with 1Password.
Incorrect: Chrome failed to connect to 1Password mini.
Filling and saving: Don’t use Credit Card when you can use a more natural phrase like credit card number or credit card details.
1Password can fill your credit card details.
Editing: Use Credit Card item when referring to an action that creates or changes a Credit Card item.
Edit the Credit Card item and enter your credit card details.
customer support Use when referring to the customer support team or specific team members. Not customer service. Don’t shorten to CS when talking to customers. Don’t use when when describing the initial point of contact; use 1Password Support instead. See also 1Password Support.
Hey, it’s your buddy Khad. I’m on the customer support team at 1Password.
customer support code Lowercase. A code the Customer Success team uses to verify customers before they provide phone support. Don’t use when you mean authentication code or verification code.
Dark Mode, dark theme. Note capitalization. Don’t use Light Mode. People can turn on or turn off Dark Mode and use Dark Mode. Don’t refer to device as using Dark Mode or being in Dark Mode.
Correct: 1Password looks great when you turn on Dark Mode.
Incorrect: 1Password looks great when you turn on Light Mode.
Android: Use dark theme when referring to Android.
1Password looks great when you use the dark theme.
data Singular. Rewrite to avoid, or use information if it makes sense in the context. OK to use 1Password data when referring to the account and all its information as a single entity.
Preferable: Sign in to your account to see everything you’ve saved in 1Password.
Acceptable: Your 1Password data is safe even if you lose your devices.
Avoid: Sign in to your account to see all your data.
delete Prefer remove when referring to people or move to Trash when referring to items.
Correct: Remove someone from your family account.
Incorrect: Delete someone from your family account.
Correct: 1Password is available for computers and mobile devices.
Incorrect: 1Password is available for desktop and mobile devices.
desktop app: Don’t use. Prefer the product name. OK to use app.
Preferable: Get 1Password for Windows.
Acceptable: Get the 1Password app for Windows.
Incorrect: Get the 1Password desktop app for Windows.
Correct: If you use 1Password for Mac, 1Password X can integrate with it.
Correct: When you turn on integration with 1Password for Mac, you can use Touch ID to unlock.
Incorrect: Turn on Desktop App Integration in 1Password X.
connecting: Use integrate in settings and preferences. Use communicate with in user materials. Not pair.
Correct: To communicate with the 1Password app, turn on “Integrate with 1Password for Mac”.
Incorrect: To pair with the 1Password app, turn on “Integrate with 1Password for Mac”.
1Password is available for all your devices.
diagnostics report Note the s and capitalization. Prefer describing the information you are requesting rather than the report itself, especially when using the diagnostics link rather than the 1Password troubleshooting utility.
Correct: I’d like to collect some diagnostic information about your vaults to see where the trouble may be.
Incorrect: I’d like you to send me a diagnostics report.
display Prefer appear, show, or see.
Correct: You’ll see a list of items in the Personal vault.
Incorrect: 1Password will display a list of items in the Personal vault.
Document Capitalize when referring to Document items. Use lowercase when referring to the general ability to save documents in 1Password.
domain Avoid. Use sign-in address for 1Password accounts, addresses ending with for email addresses, or website for web addresses.
Correct: Allow sign-ups from addresses ending with
Incorrect: Allowed domains (separated by commas)
To sign in to a 1Password account, you need 1Password 6 or later.
enable, disable Use turn on, turn off.
ensure, make sure Use make sure. Ensure is overly formal.
Correct: Make sure you lock 1Password when you’re finished using it.
Incorrect: Ensure you lock 1Password when you’re finished using it.
exploit (n.) Avoid. Prefer alternatives, and be more specific if possible.
Correct: Watchtower tells you about password breaches and other security problems on the websites you have saved in 1Password.
Incorrect: Watchtower alerts you to exploits for your Logins.
family organizer Lowercase. A family member who can manage vaults and groups, invite and recover accounts, view billing information, and delete their family account.
field (n.) Use to refer to fields in 1Password items.
Click the password field in the item details.
Text fields in the apps: Avoid field when referring to inputting information.
Correct: Enter your information and click Next.
Incorrect: Fill in the fields and click Next.
Text fields on a page: Prefer alternatives.
Correct: 1Password will fill your sign-in details.
Acceptable: 1Password will fill the username and password fields.
Correct: 1Password can fill usernames and passwords on pages.
Correct: Filling passwords has never been so easy.
Correct: Enter your username and password, then sign in.
Incorrect: Fill your username and password, then submit.
form (n.) OK, but prefer alternatives when you mean a form on a page.
Correct: 1Password fills your username and password on sign-in pages.
Correct: 1Password fills your credit cards in online shopping carts.
Acceptable: 1Password fills forms with a single click.
- form filling, form fill: Prefer more descriptive alternatives to these terms.
generate Don’t use. Use create or suggest.
Correct: To create a strong password, tap Suggest New Password.
Incorrect: To generate a password, tap Generate New Password.
Correct: 1Password can take you directly to a site, fill in your username and password, and sign you in.
Incorrect: Use Go & Fill to sign in to your online accounts with a single click.
Google Play Don’t use an article or store when referring to the store itself. Use both when referring to the Google Play Store app. Apps are available on Google Play.
Correct: Get 1Password on Google Play.
Correct: Open the Google Play Store app.
Incorrect: Get 1Password from the Google Play store.
Home page Note capitalization. The page you see when you sign in to 1Password.com.
See your vaults and complete quests on the Home page.
Correct: 1Password can sync with iCloud on Apple devices.
Correct: 1Password for Mac and iOS can sync with iCloud.
Incorrect: 1Password can sync with iCloud.
Incorrect: 1Password for Mac supports iCloud Sync.
iCloud Drive Use only when troubleshooting. Otherwise use iCloud.
Filling and saving: Don’t use Identity when you can use a more natural phrase like address or name and address.
Editing: Use Identity item when referring to an action that creates or changes an Identity item.
Edit the Identity item and enter your name and address.
in-app purchase We sell 1Password subscriptions as in-app purchases through Apple.
starting: Customers start a 1Password subscription, not an in-app subscription, Apple subscription or iTunes subscription. They start it using an in-app purchase, which can only be done on an Apple device.
Correct: Start your 1Password subscription using an in-app purchase on your Apple device.
Incorrect: Start your Apple subscription by subscribing through Apple.
managing: Customers who start their subscriptions using an in-app purchase manage their subscription with Apple.
Individuals Don’t use. The product is called 1Password. It doesn’t need to be distinguished from 1Password Families, 1Password Teams, and 1Password Business because they already carry that designation. See also 1Password, 1Password account, individual account.
Correct: Sign up for 1Password or 1Password Families.
Incorrect: Sign up for 1Password Individuals.
Correct: You can upgrade from an individual account to a family account.
Incorrect: You can upgrade from Individuals to a family account.
individual account Prefer 1Password account or just 1Password, unless it’s necessary to make the distinction from family account or team account. See also 1Password, 1Password account, 1Password Families, 1Password Business, 1Password Teams.
in order to Don’t use. Use to.
inside Not inside of.
Use the 1Password SCIM bridge to integrate with Okta.
Preferable: Your information is safe in 1Password.
Acceptable: Your items are safe in 1Password.
- Filling and saving: Don’t use item. Describe what’s being filled or saved. For example, fill an address.
Large Type The name of the feature. Prefer describing the behavior: enlarge passwords. Use Show in Large Type for the command.
launch Don’t use when referring to apps, files, and folders; use open.
linked account Use when referring to a family account that is linked to a business account: link a family account, unlink account, your account is linked. Family accounts are linked to business accounts; business accounts are not linked to family accounts. Not child account.
load Use appear, show, or see. If an event will take some time, say so.
Correct: Enter your Master Password. After a few moments, you’ll see your Home page.
Incorrect: Enter your Master Password, and 1Password will load your vaults.
Correct: Lock 1Password before leaving your computer.
Correct: 1Password locks when you are away for 10 minutes.
Incorrect: Lock your vault before leaving your computer.
locked out Don’t use. Describe the situation.
Correct: Recover accounts for team members who forgot their Master Password or Secret Key.
Incorrect: Recover accounts for team members who are locked out of their accounts.
lock screen Two words. Prefer describing the state of 1Password.
Preferable: 1Password will be locked.
Acceptable: You’ll see the lock screen.
Starting: Use log in to, not log into or log on to.
Log in to your Mac, then open 1Password.
Ending: Use log out of, not log off, log off of, or log out from.
Log out of your Windows account.
Filling and saving: Don’t use login when you can use a more natural phrase like password or username and password. OK to use login as shorthand for username and password especially when space is limited or using username and password would become repetitive.
Correct: 1Password can fill your usernames and passwords.
Acceptable: 1Password can fill your logins.
Editing: Use Login item when referring to an action that creates or changes a Login item.
Correct: Edit the Login item and enter your username and password.
Mac App Store version: Don’t use.
Correct: If you installed 1Password from the Mac App Store.
Incorrect: If you’re using the Mac App Store version of 1Password.
Master Password Capitalize. Don’t shorten to password. The password that unlocks a standalone vault or all vaults and accounts in 1Password 7 or earlier. Don’t use to refer to the password of a specific account. Use your rather than the when referring to a customer’s Master Password. See also 1Password account password.
member Precede with family or team or rewrite with people to avoid sounding like a horror story.
Correct: Learn how to remove people from your team.
Incorrect and scary: Learn how to remove members.
Microsoft Store version, Store version: Don’t use.
Correct: If you installed 1Password from the Microsoft Store.
Incorrect: If you’re using the Microsoft Store version of 1Password.
migrate Move from a standalone vault or vaults to a 1Password account.
modify Prefer edit or change except in the case of date modified.
multi-factor authentication Lowercase. Note hyphenation. There are two methods for multi-factor authentication in 1Password: two-factor authentication and Duo. Not MFA, 2FA, or TOTP. When referring to a specific method, use the name of the method, not the general term multi-factor authentication. See also one-time password, two-factor authentication, verification code.
Correct: Turn on two-factor authentication in 1Password.
Correct: Use Duo in 1Password Business.
Incorrect: Turn on multi-factor authentication in 1Password.
native messaging Note capitalization. Don’t abbreviate as NM.
new, existing Avoid when the context makes it clear.
Correct: Edit the Login item.
Incorrect: Edit the existing Login item.
Unlock 1Password using Touch ID on your Mac with Touch Bar or MacBook Air 2018 or newer.
once Don’t use when you mean after.
Correct: After you open 1Password…
Incorrect: Once you open 1Password…
one-time password Lowercase. Note hyphenation. An additional password that expires after a short interval. Use when referring to the field type or the use of 1Password as an authenticator for services where two-factor authentication is enabled. Not TOTP or TOTP code. Use authentication code for 1Password accounts. See also two-factor authentication.
Correct: Your one-time password is automatically copied to the clipboard.
Incorrect: Your TOTP code is automatically copied to the clipboard.
- Time-based One-Time Password: Capitalize carefully. Algorithm that computes a one-time password. OK to use TOTP after first occurrence. Avoid in user materials.
onscreen (adj., adv.) One word.
OPVault file, OPVault folder: OK on Mac and Windows, respectively.
.opvault: Use if you’re talking about a specific file or folder on disk, like 1Password.opvault. Not OPVault.
owner OK to use when it’s clear you’re referring to members of the Owners group.
password, Password Capitalize only when referring to Password items. Don’t use when you mean Master Password. See also credit card, Credit Card, Identity, item, login, Login, secure note, Secure Note.
1Password will ask to save your password.
Edit the Password item and enter a note.
passphrase: Use passphrase when referring to a password which consists of a sequence of words. Not wordlist password, words password, or Diceware password.
Correct: Use a passphrase if you’ll need to remember the password later.
Incorrect: Use a wordlist password if you’ll need to remember the password later.
Password AutoFill A set of APIs and extensions that Apple provides developers. Avoid in user materials except when referring to a user interface element that uses the term. Prefer AutoFill or describing the behavior. See also Autofill, AutoFill.
permission A vault- or group-level capability granted to a person or group that affects what they can see or do in 1Password. Always spell out the full name of the permission.
Correct: Team members with the “Create Items” permission can add information to the vault.
Incorrect: Team members who have permission to create items can add information to the vault.
plan Don’t use. When referring to the distinction between 1Password, 1Password Families, 1Password Teams, and 1Password Business, refer to each product by name.
Pro plan: 1Password Teams used to have a Pro plan. It was replaced by 1Password Business, but some customers may still be on the old Pro plan.
Back Office: Plans are called tiers in Back Office. What’s called a plan in the Back Office is something we don’t talk about with customers.
pop-up (n., adj.) Lowercase. Note hyphenation.
Premium features Don’t use. Use Pro features.
Privacy Cards Note capitalization. Virtual payment cards that protect people when they spend online.
virtual payment cards: Use virtual payment cards to explain what Privacy Cards are. Don’t shorten to virtual cards.
company name: The company name is Privacy. If the context is ambiguous, consider rewriting. OK to refer to Privacy.com as the company website, but consider rewriting to avoid.
Correct: Sign up for a Privacy account to get started.
Acceptable: Sign up for an account on Privacy.com to get started.
Incorrect: Sign up for a Privacy.com account to get started.
Ambiguous: Virtual payment cards let you pay online with privacy/Privacy.
promotion Discounted pricing on a 1Password membership.
code: Use promo code, not coupon code or promotion code.
coupon: Reword to avoid the skeuomorphic use of coupon.
Correct: Take advantage of the promotion.
Incorrect: Redeem your coupon.
Quick Fill shortcut The “Fill Login on current web page” keyboard shortcut (Command-Backslash (\) on Mac, Ctrl + backslash (\) on Windows).
random Avoid when describing the password generator or the passwords it creates unless referring to the specific property of randomness. Prefer strong or unique.
read Prefer see, have access to, or view.
recommend Avoid using we recommend or it’s recommended. State the reason. If the reason is explained in depth elsewhere, you can use a less formal phrase, like it’s a good idea to.
Correct: To make sure you always have access to your account, save your Emergency Kit.
Acceptable: It’s a good idea to use a password manager.
Avoid: We recommend that you save your Emergency Kit.
recovery Use when referring to the feature. Don’t use when referring to the process of recovering an account.
Correct: Account recovery is available to all 1Password Teams customers.
Correct: After your account is recovered, you’ll be able to sign in.
Incorrect: After the recovery, you’ll be able to sign in.
permission: Don’t use recovery permission(s). Use the “Recover Accounts” permission.
starting and finishing: Don’t use begin or complete. Prefer recover by itself. See also begin, complete.
Correct: Recover this account.
Incorrect: Begin account recovery.
group: Don’t use recovery group. Use group with the “Recover Accounts” permission.
rich icons Lowercase. Avoid. Prefer describing what happens.
Automatically download icons for Login and Software License items
run (v.), running (adj.) Don’t use.
Opening apps: Don’t use run when you mean open.
Correct: Click the 1Password icon in the Dock to open it.
Incorrect: Click the 1Password icon in the Dock to run it.
App state: Don’t use running when referring to the state of 1Password; describe the steps to determine its state. OK to use running in developer materials when referring to other apps or processes in the background with no graphical interface.
Correct: Do you see 1Password mini in the menu bar?
Incorrect: Is 1Password mini running?
Acceptable: Open Activity Monitor and check if
Software versions: Don’t use running when referring to software versions or variations. Use use or using.
Correct: If you’re using Mac OS 9, it’s time to upgrade.
Incorrect: If you’re running Mac OS 9, it’s time to upgrade.
Actions in apps: Don’t use run when referring to actions a user takes in the app. Prefer alternatives, like view, use, or check.
Correct: To review sign-in attempts, click “View report”.
Incorrect: To review sign-in attempts, click “Run report”.
Correct: To sign in to 1Password, you’ll need your Secret Key.
Incorrect: The Secret Key is combined with your Master Password.
Use a secure note to keep a list of gift ideas for friends and family.
Add a Secure Note item in 1Password to get started.
server Don’t use when talking about where 1Password data is stored or sent.
Correct: Your data is stored in your 1Password account.
Incorrect: Your data is stored on our servers.
Incorrect: Your Secret Key is never sent to the server.
Correct: 1Password.com is temporarily unavailable.
Incorrect: The server is down.
setup (n., adj.), set up (v.) One word except as a verb.
sign in (v.), sign-in (adj.) Two words. Note hyphenation of adjective. Not sign into. Use sign in to for websites and sign in on for devices.
Correct: Sign in to 1Password.com.
Incorrect: Sign in on 1Password.com.
Correct: To sign in on another device, scan your Setup Code.
sign-in address Lowercase. Note hyphenation.
sign up (v.), sign-up (adj.) Two words. Note hyphenation of adjective. Use sign up for, not sign up to.
since, because Use since to mean during the period subsequent to the time when. Use because to mean for the reason that.
Correct: You haven’t changed your password since the breach.
Correct: Because you saved your Emergency Kit, you’re not locked out.
Incorrect: Since you saved your Emergency Kit, you’re not locked out.
standalone (adj.) Don’t use standalone by itself.
licensing: Don’t use standalone as a noun or part of a product name or version. Prefer rephrasing in terms of a 1Password membership.
Preferable: Travel Mode is available for everyone with a 1Password membership.
Acceptable: Travel Mode isn’t available for standalone license holders.
Incorrect: Travel Mode isn’t available in standalone.
Incorrect: Travel Mode isn’t available in 1Password Standalone.
Incorrect: Travel Mode isn’t available in the standalone version.
vaults: Vaults outside of 1Password accounts are standalone not local. Note that you can create standalone vaults even if you have a 1Password membership.
Correct: You can sync standalone vaults with Dropbox.
Incorrect: You can sync local vaults with Dropbox.
success, fail Avoid when referring to the status of an action.
Correct: The account was recovered and is ready to use.
Correct: The account could not be recovered.
Incorrect: Account recovery successful.
Incorrect: Account recovery failed.
submit Use sign in when referring to submitting a sign-in form.
subscription Use when referring to the ongoing nature of a 1Password membership (especially in contrast to a standalone license): manage your subscription, cancel your subscription. Don’t use subscribe as a verb; use start your subscription. See also 1Password membership, billing.
Manage your subscription on 1Password.com.
Purchase your 1Password Families membership with a monthly or annual subscription.
sync (v.), syncing (n.) Don’t use when referring to 1Password accounts. Syncing implies that devices are syncing with each other rather than your 1Password account. Use alternatives like appear automatically or available everywhere. Use saved in or stored in to refer to changes to items in a 1Password account.
Correct: All your items appear automatically on all your devices.
Correct: When you edit an item, it’s saved in your 1Password account.
Incorrect: When you edit an item, it’s synced with your 1Password account.
- iCloud, Dropbox, WLAN server: Sync with, not sync using or sync to.
ticket Internal name for a support email conversation. Don’t use when talking to customers.
Correct: I’ve asked another member of the team to take a look at our conversation.
Incorrect: I’ve escalated your ticket to Level 2.
Touch ID Two words. Don’t use as an adjective (Touch ID unlock).
Travel Mode Note capitalization.
safe for travel: Note capitalization. Vaults are marked as safe for travel not tagged.
Managed Travel Mode: Not Advanced Travel Mode, Admin Travel Mode, or anything else. Prefer describing the actions after first occurrence.
Preferable: If you’re a team administrator, you can turn Travel Mode on and off for team members and manage which vaults are safe for travel.
Acceptable: If you’re a team administrator, you can use Managed Travel Mode with your team.
- authentication code: Lowercase. The six-digit code used to authorize a device when two-factor authentication is turned on in 1Password. Don’t use when you mean customer support code or verification code.
Universal Windows Platform (UWP) Don’t use. Especially not UWP version.
Correct: Get 1Password from the Microsoft Store to use it on all your Windows 10 devices.
Incorrect: Install the UWP version instead of the Desktop version.
unlock (v.), unlocked (adj.) People can unlock 1Password, but 1Password doesn’t unlock itself. You can’t unlock a vault, and vaults can’t be unlocked. Use sign in when referring to 1Password.com. See also lock, locked.
Correct: Open and unlock 1Password.
Incorrect: Unlock your vault.
Incorrect: 1Password unlocks when you type in your Master Password.
update 1Password can update items and itself. Use edit when referring to a user-made change to an item, person, vault, or group.
upgrade Use when referring to major versions of the apps and different account types.
apps: Use upgrade or switch depending on the version.
later version: Use upgrade.
Upgrade to 1Password 7 for Mac.
earlier version: Use switch. Not downgrade.
Switch to 1Password 3 for Mac.
change account type: Use upgrade or switch depending on the account type you’re changing to. Don’t use convert.
1Password Families, 1Password Teams, or 1Password Business: Use upgrade.
Upgrade to 1Password Families.
individual account: Use switch. Not downgrade.
Switch to an individual account.
URL Use sign-in address when referring to 1Password accounts. OK to use when referring to the field in Login items, but prefer website.
U.S. Note spacing and periods. Use as an adjective only. As a noun, use United States. Don’t use periods when used near country and region name abbreviations that don’t use periods. Not America or USA. See also EU, UK.
Correct: Boxing Day is a holiday for U.S. employees.
Acceptable: Boxing Day is a holiday for UK, US, and Canadian employees.
Incorrect: Boxing Day is a holiday for employees in the U.S. and other countries.
user Don’t use as an adjective (user account). Prefer person, team member, or family member. Prefer customer in sales and marketing materials when referring to people who use 1Password.
username One word.
vault Don’t use vault unless you need to refer to a specific vault.
Correct: Create a new Login item in 1Password.
Correct: Create a new Login item in your Shared vault.
Incorrect: Create a new Login item in your vault.
family vault, team vault: Avoid. Use vault in your 1Password account, or just 1Password account if the specific vault isn’t relevant.
Shared vault: Capitalize Shared when referring to the default vault that’s shared with everyone in a family or team. Lowercase when referring to other vaults that are shared.
Your Vault: Don’t use. Just don’t.
Vault menu Note capitalization. Not Vault Switcher, Vault Picker, Vault Selector. Avoid. Instead, describe the action the user takes.
Correct: Click All Vaults and choose a vault.
Incorrect: Use the Vault Switcher to go to your Personal vault.
verification code Lowercase. Code sent in an email when creating a 1Password account in one of the apps. Don’t use when referring to two-factor authentication. Don’t use when you mean authentication code or customer support code. See also customer support code, two-factor authentication.
version Don’t include the word version or the letter v in the name of the app. For example, 1Password 6.5, not 1Password version 6.5. See also AgileBits Store, earlier, later, Mac App Store, newer, older.
Upgrade to 1Password 6.
The letter x: Don’t use x to mean “any number”, as in 6.x; use a specific number or range of numbers.
Outdated: Software that doesn’t have the latest features or security fixes. Not out of date.
Your browser is outdated. Update to the latest version.
Beta releases: When an app won’t open after a specific date, it expires. Prefer expired when referring to beta releases.
via Don’t use. Use a more precise word or phrase like by, from, through, or using.
Watchtower Capitalize. Not Watchtower service or 1Password Watchtower.
while, although, whereas While means during the time that and implies concurrent activities. Use although to mean in spite of the fact that. Use whereas to mean it being the fact that or while on the contrary.
Correct: Although you can reuse passwords, it’s safer to use unique ones.
Incorrect: While you can reuse passwords, it’s safer to use unique ones.
Correct: 1Password has an open security design, whereas other password managers may not.
Incorrect: 1Password has an open security design, while other password managers may not.
Correct: Set up the WLAN server.
Correct: Sync with the WLAN server.
Incorrect: Use WLAN sync.