Skip to content
Guides

Turn on two-factor sign-in

Two-factor sign-in asks for a 6-digit code from an authenticator app (1Password, Google Authenticator, Authy) each time you sign in on a new device. It's optional, except for the owner of a workspace whose plan requires it, and for admins of a workspace that requires it of its admins.

Set it up

  1. Open Account settings (Account menu → Account settings) and choose Security.
  2. Under Two-factor sign-in, which says Off, press Set up. If ShipVitals asks you to Confirm it's you, sign in again with one of your methods; you come back to the dialog.
  3. Scan this code with your authenticator app. Can't scan it? Use the key under Can't scan it? Enter this key instead:. Press Next.
  4. Enter the 6-digit code the app shows. The dialog moves on by itself after the sixth digit.
  5. Save your recovery codes: press Copy all or Download (on a phone, Share) and keep them in your password manager. Tick I've saved these codes, then press Done.

Two-factor sign-in now says On · since … with how many recovery codes are left ("10 recovery codes left").

Sign in with a code

After the sign-in link or Google/GitHub, the page says Enter your code. Type the 6-digit code from your app; you're signed in after the sixth digit.

Lost your authenticator

  1. On Enter your code, press Use a recovery code instead.
  2. Type one of your recovery codes in Recovery code (case and dashes don't matter) and press Use recovery code.
  3. The page says Sign in again. Your recovery code turned two-factor sign-in off, ended every session and voided your other codes. ShipVitals emails you about it.
  4. Sign in again. The page says Two-factor sign-in is off: press Set up two-factor sign-in to set it up with your new authenticator.

New codes, or turning it off

On Account settings → Security:

  • New recovery codes → Get new codes replaces every old code.
  • Turn off turns two-factor sign-in off, unless a workspace you own or manage requires it.

Both need a recent sign-in; ShipVitals asks you to Confirm it's you when it's been more than 10 minutes.

When a workspace requires it

The owner of a workspace whose plan requires two-factor sign-in sees a note: "Two-factor sign-in is required for the owner of … from …". For 7 days nothing is blocked. After that, actions only the owner can take (transfer, deletion, the admins' two-factor rule) stop until you press Set it up. Everything else keeps working.

When a workspace's owner turns on Require two-factor sign-in for admins (workspace Settings → Security), its admins see "Two-factor sign-in is required for admins of … from …". After 7 days, an admin without it can't use the workspace until they press Set it up.