> ## Documentation Index
> Fetch the complete documentation index at: https://docs.custral.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Security

> Your password, two-step authentication (authenticator app, text message, passkeys and recovery codes), how to get back in when a method is lost, and deleting your account.

## Overview

**Settings → Security** (in the **Account** group of the settings sidebar) holds
everything about how you sign in: your password, two-step authentication,
passkeys and recovery codes, texting Stella from your phone, and deleting your
account. The devices you're signed in on have their own page,
[Sessions](https://docs.custral.com/start/security/sessions.md), right below it.

These settings belong to your account, not to a workspace. If you're a member of
several workspaces, one password and one set of two-step methods cover all of
them, and no workspace admin can turn your two-step authentication off.

## Password

**Change password** emails a reset link to your address. Changing your password
signs out every other device.

## Two-step authentication

Two-step authentication asks for a second factor after your password (or your
Google sign-in). You can turn on any combination of methods:

| Method | How to set it up |
| - | - |
| **Authenticator app** | Turn on the switch, scan the QR code with an app like Google Authenticator or 1Password (or enter the code shown under it), type the 6-digit code and click **Verify and enable** |
| **Phone verification (SMS)** | Turn on the switch, enter your number, click **Send code**, then type the code you're texted and click **Verify and enable** |
| **Passkeys** | Click **Add a passkey**, give it a name so you can tell your passkeys apart, click **Continue**, then confirm with Touch ID, Face ID, Windows Hello or a security key |
| **Recovery codes** | Click **Generate codes** once any other method is on (below) |

### Passkeys

A passkey is a second factor **and** a whole sign-in on its own. On the sign-in
page, **Sign in with passkey** signs you in with no email and no password, and
browsers that support it also offer your passkey from the email field.

Each passkey on the Security page shows when it was added and last used
("Used 3 days ago"), with buttons to rename or remove it. Removing your last
passkey turns passkeys off for the account, and if no other method is left, your
recovery codes go with it.

**Add a passkey** is greyed out when the browser or device can't create one.

### Recovery codes

Recovery codes get you in when you've lost your phone or security key. Each
code works once.

1. Click **Generate codes**. **Save your recovery codes** shows ten codes once,
   with **Copy** and **Download**. Custral stores them scrambled, so it can't
   show them again.
2. Keep them somewhere safe, away from the device you use for two-step.
3. The Security page counts what's left ("8 of 10 remaining").

**Regenerate** replaces the whole set: the old codes stop working at once.
Without codes, the page warns "No recovery codes. If you lose your device
you'll be locked out."

### Confirming it's you

Generating recovery codes, turning a method off, removing a passkey, unlinking a
sign-in method and deleting your account each ask you to **Confirm it's you**
first: with your current password, a current two-step code, your passkey, or a
code emailed to you if your account has none of those. A confirmation lasts five
minutes on that device.

## Signing in with two-step

After your password, Custral asks for your second factor:

* With more than one method, **How do you want to verify?** lets you pick a
  passkey, the authenticator app or a text message. A text is sent only when you
  pick it.
* **Use another method** switches between them.
* A recovery code works in any code box.

### If you can't use any of them

Choose **Can't use any of these?** (or **Can't use this method?**). Then, in
order:

1. Type a **Recovery code**.
2. With no recovery codes, **Email me a recovery link**. Opening the link starts
   a **24-hour wait**, and Custral warns you by email and text at once, with a
   link to cancel. After the wait, your next sign-in (password or Google) turns
   two-step off, signs out every device, and you can set it up again.
3. Still stuck? **Contact support** from the same screen.

Signing in with any working code during the wait cancels the recovery.

> [!NOTE]
>
> The mobile app has no passkey prompt yet. If a passkey is your only method,
> sign in on the phone with a recovery code.

## Text Stella

Once Custral's Stella phone number is live, the Security page shows **Text
Stella**: text questions to Stella about the workspace from your own phone, and
any changes it proposes wait for your approval in the Custral app. Until then
the section isn't shown.

Click **Set up**, enter your **Mobile number**, tick the box agreeing to receive
texts (it's optional, and nothing else in Custral needs it), and enter the code
you're sent. The section then shows your number, the number to text, and a
**Re-verify by** date. After that date, texts get no reply until you click
**Verify again**.

Texting Stella is set up per workspace. If an admin has turned it off, the
section says so and **Set up** is disabled.

## Deleting your account

Deleting your account removes your ability to sign in and deletes your personal
user record. It is **permanent**. There is no undo and no recovery window.

There are three ways to start it, and which one you use depends only on whether
you can still sign in.

> [tab] Web
>
> Go to **Settings → Security** and choose **Delete account** at the bottom of
> the page. **Delete your account?** names the workspaces you'll lose access
> to; type `delete` to confirm.

> [tab] Mobile
>
> Open **Settings → Account** in the iPhone or Android app and choose
> **Delete account**. Confirm in the sheet that appears.

> [tab] Can't sign in
>
> Go to [custral.com/request-deletion](https://custral.com/request-deletion),
> enter your email address, and we'll send you a confirmation link. Deletion
> runs when you click the button on that page, not when the email is opened,
> so a mail scanner can't trigger it on your behalf.

### What is and isn't deleted

| Deleted | Kept |
| - | - |
| Your sign-in credentials and linked login providers | Workspace data you created: records, conversations, calls, documents |
| Your personal user record in each workspace | The workspaces themselves, and everyone else's access to them |
| Your active sessions on every device | A record that a deletion was requested and honoured |

> [!WARNING]
>
> **Deleting your account is not the same as deleting a workspace.** Records,
> conversations, and calls belong to the workspace, not to you, and they stay
> with it so your teammates' history isn't torn up. To start a workspace over, an
> owner can use **Reset workspace** on [Workspace settings](https://docs.custral.com/start/onboarding/workspace.md#reset-workspace).

### If you're the only admin

If you're the last remaining admin of a workspace, your account is still
deleted, but the request is flagged for a person to review, so someone can
decide what happens to that workspace's data rather than leaving it
unadministered. You'll get an email confirming the outcome either way.

> [!NOTE]
>
> For privacy reasons, the public request form gives the same response whether or
> not an address has an account, so it can't be used to find out who has one.
> If you don't receive the email, check the address you entered.

## Troubleshooting

| Symptom | Likely cause | What to check |
| - | - | - |
| Authenticator codes are rejected | Your phone's clock has drifted, or the code expired while you typed it | Set your phone's time to automatic, then use the next code |
| No SMS code arrives | The number was entered in the wrong format | Re-enter it in international format (`+1…`) and send the code again |
| **Add a passkey** is greyed out | This browser or device can't create passkeys | Try another browser, or add the passkey from your phone or a device with Touch ID, Face ID or Windows Hello |
| "Passkeys aren't available on this address. Open Custral at app.custral.com." | You opened Custral on an address passkeys aren't registered for | Open [app.custral.com](https://app.custral.com) and try again |
| "That passkey is already on your account." | The authenticator you picked already holds a Custral passkey | Use it as it is, or rename the existing one |
| "That passkey didn't work. Try again, or use another way to sign in." | The passkey was cancelled, or it belongs to another account | Try again, or choose **Use another method** |
| "Too many incorrect codes. Wait 15 minutes and try again, or contact support." | Too many wrong codes in a short time | Wait 15 minutes. A recovery code works once the hold ends |
| "This sign-in expired. Please sign in again." | The two-step screen was left open too long | Sign in with your password again |
| "This recovery link has expired or was already used." | Recovery links work once, for an hour | Sign in again and ask for a new link |
| "Text messages aren't set up for this account." | You picked text on an account with no phone method | Choose another method, or **Can't use this method?** |
| **Text Stella** isn't on the Security page | The Stella phone number isn't live yet | Expected. The section shows once there's a number to text |
| "We couldn't confirm it's you. Try again." | The password or code in **Confirm it's you** was wrong | Re-enter it, or pick another way to confirm |

> [!NOTE]
>
> When reporting an issue, include the request id shown in the error toast. It
> links the in-app error to the server logs.

## Related

* [Sessions](https://docs.custral.com/start/security/sessions.md): the devices signed in to your account.
* [My Account](https://docs.custral.com/start/account/overview.md): your profile and the rest of the Account settings.
* [Team permissions](https://docs.custral.com/team/permissions/access.md): what your role can do inside a workspace.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.