Developer Resources

1Password Style Guide


1 | A | B | C | D | E | F | G | H | I | J | K | L | M | N | O | P | Q | R | S | T | U | V | W | X | Y | Z

1Password Style Guide

January 2024 Edition

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.

Other resources

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 January 2024 edition of the 1Password Style Guide includes updated guidelines for buttons and other user interface elements and links. It also includes updated entries for Advanced Protection, browser extension, passkey, and verification code.

Make a suggestion

If you have a suggestion to improve the 1Password Style Guide, contact styleguide@1password.com. If you work at 1Password, you can file a style guide issue.

Fundamentals

Abbreviations

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.

Browsers

When listing browsers, use this order: Chrome, Firefox, Edge, Brave, Safari. In materials that focus on Mac and iOS specifically, move Safari to the beginning of the list.

Buttons and other user interface elements

If a user interface element uses sentence- or title-style capitalization, match the capitalization style. If an element uses all caps or all lowercase, use title-style capitalization.

When referencing a user interface element that a person interacts with, use bold formatting. Exclude any sentence punctuation, symbols, or separators from the bold formatting.

Select File > New Item.

When referencing other elements, don't use bold formatting, and include quotation marks around elements that use sentence-style capitalization.

In the "Join the beta" section, select Join.

ContextFormatting
A title-cased element that you're instructing someone to interact withAdd to Favorites
A title-cased element that you aren't instructing someone to interact withAdd to Favorites
A sentence-cased element that you're instructing someone to interact withKeep 1Password in the menu bar
A sentence-cased element that you aren't instructing someone to interact with"Keep 1Password in the menu bar"

Capitalization

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.

Commas

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. Use the singular pronoun it to refer to a company.

Correct: Eero, Yahoo, Hey

Incorrect: eero, Yahoo!, HEY

Correct: Apple announced it will be launching the product.

Incorrect: Apple announced they will be launching the product.

Contractions

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.

Currency

Prefix amounts with a currency symbol. Follow with a space, then an International Organization for Standardization (ISO) currency code.

Use a period as a decimal separator for fractional amounts. For amounts greater than 1,000, use commas to separate the numerals into groups of three. For amounts greater than 1 million, write out million, billion, and so on; OK to include up to two decimal places.

$1 CAD

£1,999.99 GBP

€1.25 million EUR

$999 USD

Dashes

Use spaced en dashes to separate phrases. Don’t use em dashes or hyphens.

Correct: Data is encrypted at rest and in transit – just like in the other 1Password apps.

Incorrect: Data is encrypted at rest and in transit—just like in the other 1Password apps.

Incorrect: Data is encrypted at rest and in transit-just like in the other 1Password apps.

Database jargon

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. OK to use in developer documentation. See also add, remove, begin, complete, connect, delete, display, enable, disable, load, modify, new, existing, read, success, fail, update.

Ellipses

Use sparingly. Include a space before and after the ellipsis except when combined with other punctuation.

a … b  c….  d…,  e, … f  g…?  h…!

Headers and section titles

Use sentence-style capitalization for headers and section titles.

Image annotations

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.

-ing words

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.

Internal team names and job titles

Capitalize names of internal teams. Don’t capitalize the word team. Use the definite article and prefix with 1Password on the first occurrence for written materials, including the apps, blog, documentation, marketing materials, social media posts, and website.

Correct: Contact the 1Password Sales team.

Acceptable: Contact the Sales team.

Incorrect: Contact the sales team.

Incorrect: Contact the Sales Team.

For job titles that appear after a name, use lowercase and commas to set off the title; OK to prefix titles with 1Password’s. Follow capitalization rules for internal team names.

Jeff Shiner, chief executive officer

Blair Melnykova, 1Password’s vice president of Product Marketing

For job titles that appear before a name, use title-style capitalization and no commas. OK to shorten C-suite titles to initialisms: CEO, CPO, CFO, and so on.

Chief Executive Officer Jeff Shiner

Vice President of Product Marketing Blair Melnykova

Only use first person plural pronouns in personal communication, like the 1Password Support Community, email, and social media replies.

Our Sales team can help you.

I asked our director of Security about that.

Use descriptive link text. If the link text is a complete sentence, include terminal punctuation. If an external link occurs at the end of a sentence, include terminal punctuation followed by the external link icon.

Correct: [Upgrade to 1Password Business.](/business/)

Correct: Get started with [1Password Business](/business/).

Correct: Open the Google Cloud Marketplace and find the [Admin SDK API. ](https://console.cloud.google.com/marketplace/product/google/admin.googleapis.com)

Incorrect: [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. Follow the capitalization used in the article title.

  • 1Password homepage: Don’t include homepage in link text. Prefer 1Password.com. See also 1Password.com, homepage.

  • Other 1Password pages: Prefer descriptive link text. OK to use the page title as the link text if it makes sense to do so; follow the capitalization used in the title. Avoid two-word descriptions ending in page; if unavoidable, capitalize the name of the page, for example: Downloads page, Jobs page.

    Correct: [Check out the latest news, media, and press resources from 1Password.](/press/)

    Acceptable: Visit [The Press Room](/press/) to check out the latest news, media, and press resources from 1Password.

    Avoid: Visit the [Press page](/press/) to check out the latest news, media, and press resources from 1Password.

Lists

Use numbered lists for steps that should be followed in order.

  1. Unlock 1Password.
  2. Choose 1Password > Preferences, then click Security.
  3. 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.

Operating systems

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.

Platforms

When listing platforms, use this order: Mac, iOS, Windows, Android, Linux, ChromeOS.

Quotation marks

Put punctuation marks outside quotation marks, unless quoting a person. OK to include original punctuation inside quotation marks.

Correct: “Writing is thinking,” said David McCullough. “To write well is to think clearly. That’s why it’s so hard.”

Incorrect: “Writing is thinking”, said David McCullough. “To write well is to think clearly. That’s why it’s so hard.”

Spelling

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.

Time zones

When using an abbreviation to indicate a time zone, don't refer to daylight savings or standard time. Use ET (Eastern time) and PT (Pacific time) in marketing communications. OK to refer to other time zones if needed.

Correct: On Tuesday, April 12 at 8 AM PT / 11 AM ET.

Incorrect: On Wednesday, April 13 at 8 AM PST / 11 AM EST.

Acceptable: On Thursday, April 14 at 10 AM CET.

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.

Ease

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. OK to use outside of task-based steps to encourage customers toward an option that will benefit them.

Correct: Sign up on 1Password.com.

Incorrect: Simply sign up on 1Password.com.

Correct: To edit an item, select it and click Edit.

Incorrect: To edit an item, just select it and click Edit.

Correct: 1Password Families is the easiest way for your whole family to use 1Password.

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.

Exclamation points

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.

Negative language

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.

Placing blame

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.

Please

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.

Preemptive apologies

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

When providing instructions, don’t tell people what they want, should, or could do. Stick to the facts.

Correct: Sign in to your account on 1Password.com.

Incorrect: You’ll want to sign in to your account on 1Password.com.

OK to use need only when referring to something that a user factually must do to accomplish a goal.

Before you can fill a credit card or address, you’ll need to save it in 1Password.

Terminology and usage

1

1Browser Don’t use. Use the 1Password browser. See also 1Password extension.

1Password Can refer to the company, the 1Password app, 1Password in the browser, the entire service, or an individual 1Password account. See also 1Password account, individual account.

  • browser: Use 1Password in the browser, the 1Password browser extension, or describe the action the user takes in the browser. Prefer 1Password browser extension when contrasting with the app or 1Password.com, or when 1Password in the browser may be unclear. Avoid 1Password extension or extension.

    Correct: Get 1Password in your browser.

    Correct: Review your settings for the 1Password browser extension.

    Correct: Use 1Password to save and fill passwords in your browser.

    Incorrect: Unlock the 1Password extension when you unlock the app.

    • 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.

  • 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.

  • Referring to the company: Use singular verbs with 1Password when referring to the company as a whole.

    Correct: 1Password is powered by a global team of great people.

    Incorrect: 1Password are powered by a global team of great people.

  • possessive: Don’t use 1Password’s unless referring to 1Password as a company.

    Correct: 1Password’s focus is always customer satisfaction.

    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: 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.

Correct: Sign in to your account on 1Password.com.

Avoid: Sign in to your account on 1Password.com using your account password.

Preferable: Open and unlock 1Password.

Acceptable: Open 1Password and enter your password.

1Password apps The full names are 1Password for Mac, 1Password for iOS, 1Password for Windows, 1Password for Android, and 1Password for Linux. Omit the platform unless the distinction is necessary. See also 1Password.com, app.

  • version numbers: Leave out unless necessary. See also version.

    1Password 7 requires macOS High Sierra 10.13 or later.

    Make sure you’re using the latest version of 1Password.

  • 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.

  • desktop app, mobile app: Use the product name if including the platform provides clarity. OK to use when space is limited or using product names would become repetitive.

    Correct: In the 1Password desktop apps, you can use Quick Access to quickly search for your items.

    Correct: You can use 1Password for Mac to autofill your usernames and passwords in apps.

  • client app: Use 1Password app if you need to make the distinction from 1Password.com. OK to use in developer resources to distinguish between 1Password servers, like 1Password Connect Server.

    Correct: You can use the 1Password app or sign in to your account on 1Password.com.

    Acceptable: The 1Password Events REST API only captures actions from client apps using 1Password 8.4.0 or later.

    Incorrect: Download the 1Password client app.

  • native app: Don't use native as a selling point when referring to the design of the 1Password apps.

    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.

1Password Business, 1Password Teams Not 1Password Businesses, 1Password for Business(es), or 1Password for Teams. Don’t shorten to Business(es) or Teams. See also 1Password account.

  • 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 classic extension Use the definite article: the 1Password classic extension. OK to use the classic extension after first occurrence. Not 1Password extension, browser extension, or extension. See also 1Password.

1Password CLI Note capitalization. The command-line tool available to everyone with a 1Password account. Don’t use a definite article. Don’t shorten to CLI. See also CLI.

  • command-line tool: Note hyphenation. Use command-line tool to explain what 1Password CLI is. OK to use the tool after first occurrence.

  • command line: No hyphen. Use command line when describing where you can use 1Password CLI.

  • op: Don’t use op as the name of the tool. Only use op to provide example commands.

    Correct: To get help using 1Password CLI, enter op --help.

    Incorrect: To get help using op, enter op --help.

1Password Connect Server Note capitalization. Don't use a definite article. Don't shorten to Connect Server. OK to use the Connect server after first occurrence or when referring to a specific instance. For possessives, use your Connect server.

Deploy 1Password Connect Server using Docker.

Share information from 1Password with your applications through a REST API provided by the Connect server.

Configure your Connect server.

1Password Events Reporting Note capitalization. Don't shorten to Events Reporting. OK to use events reporting after first occurrence. For possessives, use your events reporting.

Learn how your data is protected when you use 1Password Events Reporting.

Set up an events reporting integration.

The URL for your events reporting API uses the same domain as your 1Password account.

1Password extension Don’t use when referring to 1Password in a browser on a Mac or PC. Use only when referring to the 1Password extension for iOS. OK to use the extension after first occurrence. Not app extension or iOS extension. See also 1Password.

1Password Families Not 1Password for Families. Don’t shorten to Families. See also 1Password account.

  • 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. 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.

Incorrect: Purchase your 1Password account today with a monthly or annual subscription.

  • trial: Avoid. Rephrase as try free for 14 days.

1Password mini Note capitalization. Only use when referring to the interface that appears in 1Password 7 or earlier when you click the 1Password icon in the toolbar in Safari, the menu bar on Mac, or the notification area on Windows. Don’t shorten to mini. See also 1Password.

1Password SCIM Bridge Note capitalization. OK to use the SCIM bridge after first occurrence. For possessives, use your SCIM bridge.

Deploy 1Password SCIM Bridge on Azure Kubernetes.

The SCIM bridge is a secure proxy for provisioning.

The URL for your SCIM bridge.

1Password Support Capitalize when referring to support.1password.com and contacting 1Password for support. See also 1Password Support Community.

  • 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 Don’t use. See 1Password.

A

account details Includes the sign-in address, email address, Secret Key, and password for a 1Password account. Don’t use when you mean Setup Code. See also Secret Key, Setup Code.

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 Key Don’t use. See Secret Key.

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 the Archive, or delete 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 Don't use. Refer to team policies instead, like firewall rules.

AgileBits The company’s legal name is AgileBits Inc. Avoid in user materials. Use 1Password when referring to the company or its team members unless the distinction is necessary to avoid confusion, particularly in legal or security documentation. See also 1Password.

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 Our old store we no longer use. Not Agile Web Store, webstore, AWS, or anything else. See also Mac App Store.

  • 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 7.8 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.

allall of
nouns
All the apps are included.
pronouns
All of them are included.
possessive pronouns
All her passwords are strong.
possessive nouns
All of Lisa’s passwords are strong.

All Vaults Capitalize. Only use to describe the feature in 1Password 7 or earlier. Don’t use an article. Don’t use as an adjective.

Correct: Switch to All Vaults to see all your items at the same time.

Incorrect: Switch to the All Vaults view to see all your items at the same time.

app Use singular when walking the user through a specific use case. Use plural when describing functionality. See also 1Password apps.

Correct: You can also move items in the app.

Correct: 1Password uses secure input fields to prevent other tools from knowing what you type in the 1Password apps.

Incorrect: You can also move items in the apps.

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.

authorized device Don't use. Use trusted device instead.

Autofill (n.), autofill (v.) Note capitalization. The 1Password feature is Autofill. Use autofill for the verb. See also Password AutoFill.

With 1Password, you can autofill passwords, addresses, and credit cards.

To fill your username and password, 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.

B

Back Office Two words. Note capitalization.

because See since, because.

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.

browser extension A generic browser extension. OK to use 1Password browser extension when contrasting with the app or 1Password.com, or when 1Password in the browser may be unclear. See also 1Password.

C

CLI Command-line interface. Don’t use when you mean 1Password CLI. OK to use CLI if you need to make the distinction from a GUI (graphical user interface). See also 1Password CLI.

Correct: 1Password CLI is available for Mac, Windows, and Linux.

Incorrect: The CLI is available for Mac, Windows, and Linux.

Acceptable: 1Password is available as a CLI and a GUI.

clipboard One word. Lowercase.

cloud Avoid. Name the specific cloud service instead. See also sync.

Correct: All your information is available in your 1Password account.

Correct: All the information in your standalone vault is synced with iCloud.

Incorrect: All the information in your standalone vault is sent to the cloud.

computer Use to refer to desktop and laptop computers generally. When possible, be specific: Mac, Windows PC, Linux PC. See also device.

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.

Control-click Don’t use. See right-click.

credit card, Credit Card Capitalize only when referring to Credit Card items. See also Identity, item, login, Login, password, Password, secure note, Secure Note.

  • 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 1Password Business customers before they provide phone support. Don’t use when you mean authentication code or verification code.

D

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.

Correct: Remove someone from your family account.

Incorrect: Delete someone from your family account.

desktop The area behind the windows on a computer. Users can store files on the desktop and change the desktop picture. Don’t use when you mean computer. See also computer, Home screen.

Correct: 1Password is available for computers and mobile devices.

Incorrect: 1Password is available for desktop and mobile devices.

Desktop App Integration Don’t use. See Shared Lock State.

device Use to refer to computers and mobile devices collectively. See also computer.

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.

docs Avoid. Use documentation instead.

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)

downgrade Don’t use unless the distinction is necessary to avoid confusion, particularly in billing-related situations or when quoting text the user will see in interface elements. See also upgrade.

Correct: To switch from 1Password Business to 1Password Teams, click Confirm downgrade.

Correct: When you downgrade your account, your subscription payment will be adjusted on your next renewal date.

Incorrect: If you're the only person using your family account, you can downgrade to an individual account.

Dropbox Can only be used with standalone vaults. Don’t use Dropbox Sync. Sync with, not sync using or sync to. Vaults are stored in Dropbox. See also sync.

Correct: You can sync standalone vaults with Dropbox.

Incorrect: You can sync 1Password with Dropbox.

E

earlier, later Use to refer to software versions. Not lower or higher, or newer or older. See also newer, older, version.

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.

enter Use enter to describe how a person inputs information. It accounts for all methods of inputting information, including copy and paste, dictation, drag and drop, and assistive devices. Don’t use type unless describing the specific action of using a computer keyboard.

Correct: Enter your 1Password account password.

Incorrect: Type your 1Password account password.

environment file A configuration file used to define environment constants. Don’t use Dotenv or env. OK to use .env when referring to examples of specific environment files.

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.

EU No periods. OK to use as adjective or noun. OK to use European Union as a noun. See also UK, U.S..

extension See 1Password extension.

F

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.

fill (v.), filling (n.) 1Password fills information on pages. Use filling as the noun. Don’t use when you mean enter. See also submit.

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.

  • opening and filling: Use fill in browser. Don’t include open as part of the action. Fill in browser implies opening the website first.

    Correct: To open the website and fill your username and password, click Fill in browser.

    Incorrect: To open the website and fill your username and password, click Open & Fill.

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.

G

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.

Go & Fill Don’t use. Describe the behavior: fill in browser. See also fill.

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.

H

Home page Note capitalization. The page you see when you sign in to 1Password.com. See also Home screen, homepage.

After you sign in, you’ll see your vaults on the Home page.

Home screen Two words. Note capitalization. The main screen on a mobile device. Don’t use when you mean Home page. See also desktop, Home page.

homepage One word. The entry point to a website. For the homepage of the 1Password website, use 1Password.com instead. See also Home page.

Correct: Visit 1Password.com.

Incorrect: Visit the 1Password homepage.

I

iCloud Don’t use iCloud Sync. Can only be used with standalone vaults on Apple devices. Sync with, not sync using or sync to. See also sync.

Correct: Your standalone vaults can sync with iCloud on Apple devices.

Incorrect: 1Password for Mac and iOS can sync with iCloud.

iCloud Drive Use only when troubleshooting. Otherwise use iCloud.

Identity Prefer address unless it’s necessary to refer to an Identity item. See also credit card, Credit Card, item, login, Login, password, Password, secure note, Secure Note.

  • 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.

integrate (v.), integration (n.) Use to describe two apps or services working together. Or to refer to products other than the 1Password apps that connect to 1Password as a service. See also Shared Lock State.

Use 1Password SCIM Bridge to integrate with Okta.

Build your own integration using 1Password CLI.

item Prefer information when you aren’t referring to a specific item or items. See also credit card, Credit Card, Identity, login, Login, password, Password, secure note, Secure Note.

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.

L

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 password. After a few moments, you’ll see your Home page.

Incorrect: Enter your password, and 1Password will load your vaults.

lock (v.), locked (adj.) People can lock 1Password, and 1Password can lock itself. You can’t lock a vault, and vaults can’t be locked. See also unlock, unlocked.

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 account 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.

log in, log out Use only when referring to a Mac or Windows system account. See also sign in, sign-in.

  • 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.

login, Login Capitalize only when referring to Login items. See also credit card, Credit Card, Identity, item, password, Password, secure note, Secure Note.

  • 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: Prefer 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.

M

Mac App Store Don’t abbreviate as MAS. See also AgileBits Store.

  • 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.

Managed service provider (MSP) Refers to an organization that manages 1Password on behalf of another business. OK to use MSP after first occurrence. See also 1Password Business, 1Password Teams.

  • link, unlink: A technician at an MSP can link or unlink their client's business account.

    Correct: Your managed service provider (MSP) has requested to unlink your account.

    Incorrect: Your managed service provider (MSP) has requested to disconnect your account.

  • managed company: An MSP client managed by a technician.

  • technician: Someone within an MSP who helps manage a client's 1Password account.

Masked Emails Note capitalization. Unique email aliases that protect people when they sign up for accounts.

  • email aliases: Use email aliases to explain what Masked Emails are. Don’t shorten to aliases.

Master Password Don’t use. See also 1Password account password.

  • unlocking: For 1Password 7 and earlier, use password if the context is clear. Or describe the behavior.

    the password you use to unlock 1Password

  • standalone vaults: Refer to the specific vault.

    your Finance vault 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.

membership See 1Password membership.

Microsoft Store Use with an article in sentences (the Microsoft Store). See also Universal Windows Platform (UWP).

  • 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.

N

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.

newer, older Use to refer to hardware products. Not earlier or later, or higher or lower. See also earlier, later, version.

Unlock 1Password using Touch ID on your Mac with Touch Bar or MacBook Air 2018 or newer.

O

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.

Open & Fill Don’t use. Describe the behavior: fill in browser. See also fill.

OPVault format Avoid using OPVault as a standalone noun. Don’t use .opvault. Don’t use when you mean vault. See also Agile Keychain format.

  • 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.

outdated See version.

owner OK to use when it’s clear you’re referring to members of the Owners group.

P

passkey One word. Lowercase. People can save or sign in with a passkey. Avoid fill or filling when referring to passkeys. OK to substitute use for sign in when space is limited or to avoid repetition.

Correct: Use 1Password to save and sign in with passkeys.

Acceptable: You can save passkeys in 1Password and use them across your devices.

Incorrect: Save and fill passkeys using 1Password.

password, Password Capitalize only when referring to Password items. See also 1Password account password, 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. Note that Apple capitalizes the name of their feature differently than the 1Password feature. Avoid in user materials except when referring to a user interface element that uses the term. Prefer shortening to AutoFill or describing the behavior. See also Autofill, AutoFill.

password generator Lowercase. See also generate, random.

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.

plain text Don’t use plain text. Use unformatted text to mean text that doesn’t include additional styling information. Contrast with formatted text; don’t use rich text. See also plaintext.

plaintext Use plaintext (one word) to mean something that isn’t encrypted. See also plain text.

plugin (n., adj.) One word. Lowercase.

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.

Pro features Additional features in 1Password for iOS and 1Password for Android. Note capitalization. Don’t use Pro features when you mean Pro plan. See also plan.

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.

Q

Quick Fill shortcut Don’t use. Describe the behavior: fill in browser. See also fill.

R

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

right-click Lowercase. Avoid. Prefer describing steps using the primary mouse button if possible.

Correct: Select an item, then choose Edit > Archive.

Incorrect: Select an item, then right-click and choose Archive.

Acceptable: Right-click in the console, choose Save Selected, and save the console log as a file on your desktop.

run (v.), running (adj.) Avoid. OK to use run when talking about shell commands.

  • 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 the 1Password icon in the menu bar?

    Incorrect: Is 1Password running in the menu bar?

    Acceptable: Open Activity Monitor and check if cfprefsd is running.

  • 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.

S

SCIM bridge See 1Password SCIM Bridge.

Secret Key Use your when referring to the reader’s Secret Key. Don’t shorten to key. See also account details, Setup Code.

Correct: To sign in to 1Password, you’ll need your Secret Key.

Incorrect: To sign in to 1Password, you’ll need the Secret Key.

secret reference syntax Lowercase. A syntax that can be used to reference secrets saved in 1Password without putting any plaintext secrets in code. Use secret reference to refer to a secret formatted with this syntax.

secure note, Secure Note Capitalize only when referring to Secure Note items. See also credit card, Credit Card, Identity, item, login, Login, password, 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.

security key Lowercase. A device that can be used as a second factor in supported apps and browsers. OK to use U2F security key or U2F-compatible security key. Not U2F.

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 Code Not QR code, account code, or account details. See also account details, Secret Key.

setup (n., adj.), set up (v.) One word except as a verb.

Shared Lock State Don’t use in user materials. Describe the behavior. See also integrate.

Correct: If you use both the 1Password app and extension, you can unlock or lock both at the same time.

Incorrect: If you use both the 1Password app and extension, you can turn on Shared Lock State.

  • connecting: Use connect in settings and preferences. Don’t use pair.

    To unlock 1Password in your browser when you unlock the app, turn on Connect with 1Password in your browser.

shadow IT Note capitalization.

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.

Strong Password Generator Don’t use. See also password generator.

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: 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.

T

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.

tier Don’t use. See also plan.

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.

trusted device Lowercase. A device that has gone through the set-up process and can be used to set up 1Password on other devices. Use trusted device or browser where appropriate.

two-factor authentication Lowercase. Note hyphenation. Not 2FA. See also multi-factor authentication.

  • 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.

U

UK No periods. OK to use as adjective or noun. OK to use United Kingdom as a noun. See also EU, U.S..

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 after you enter your 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. See also downgrade.

  • 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.

V

vault Don’t use vault unless you need to refer to a specific vault. Capitalize specific vault names.

Correct: Create a new Login item in 1Password.

Correct: Create a new Login item in the Finance 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 vaults: 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.

Move the item to the Shared vault.

Move the item to a shared vault.

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. Use to refer to the code sent in an email when creating a 1Password account or what you enter to set up a trusted device to unlock 1Password with SSO. 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 7.8 and 1Password CLI 2, not 1Password version 7.8 or 1Password CLI version 2. See also AgileBits Store, earlier, later, Mac App Store, newer, older.

Upgrade from 1Password 7.

  • The letter x: Don’t use x to mean “any number”, as in 7.x; use a specific number or range of numbers. OK to use x when writing for a technical audience, such as developers.

    Correct: kubectl set image deploy/op-scim-bridge-1 op-scim-bridge-1=1password/scim:v2.x.x

    Incorrect: Install 1Password 7.x.

  • 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.

W

Watchtower Capitalize. Not Watchtower service or 1Password Watchtower.

web app Prefer 1Password.com. See also 1Password apps.

Wi-Fi Note capitalization and hyphenation. Use WLAN server when referring to local network syncing in 1Password. See also WLAN server.

Wi-Fi Sync Don’t use. See also WLAN server.

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.

white paper Two words. Lowercase.

WLAN server Note capitalization. Can only be used with standalone vaults. Use with an article in sentences (the WLAN server). Sync with, not sync using or sync to. Not WLAN sync or WLAN syncing. See also sync.

Correct: Set up the WLAN server.

Correct: Sync your standalone vault with the WLAN server.

Incorrect: Use WLAN sync.

Still need help?

If this article didn't answer your question, contact 1Password Support.

Published: