# 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**.
