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
- Open Account settings (Account menu → Account settings) and choose Security.
- 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.
- 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.
- Enter the 6-digit code the app shows. The dialog moves on by itself after the sixth digit.
- 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
- On Enter your code, press Use a recovery code instead.
- Type one of your recovery codes in Recovery code (case and dashes don't matter) and press Use recovery code.
- 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.
- 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.