> For the complete documentation index, see [llms.txt](https://wiki.4thtech.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.4thtech.io/products/white-label/encryption.md).

# Set up encryption

Install and set up the Encryptor extension so the app can send and read encrypted mail and chat.

{% hint style="info" %}
**Status: Production-ready, stable.** The 4thTech SDK and the BlockMail & BlockChat white-label apps are supported; no new features are planned. Last release: SDK 0.5.13 (25 Nov 2025).
{% endhint %}

BlockMail & BlockChat uses the [Encryptor](https://wiki.4thtech.io/products/encryptor.md) browser extension to encrypt for other people. The dashboard has an Encryptor widget that tells you what to do next.

Encryptor holds your encryption key. The app never sees it. Publishing your public key lets other people encrypt mail and chat messages to you.

## The widget states

| Widget title                  | What it means                                                               | What you do                                                                                                                                                                                                                                  |
| ----------------------------- | --------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Get Encryptor Now**         | The extension is not installed.                                             | Select **Install Encryptor**. It opens the [Chrome Web Store listing](https://chrome.google.com/webstore/detail/encryptor/feolajpinjjfikmmeknkdjbllbppojij). See [Install Encryptor](https://wiki.4thtech.io/products/encryptor/install.md). |
| **Ready to Set Up Encryptor** | The extension is installed but has no key yet.                              | Open Encryptor and create your key. See the [Encryptor manual](https://wiki.4thtech.io/products/encryptor.md).                                                                                                                               |
| **Unlock Your Encryptor**     | Your key exists but the extension is locked.                                | Open Encryptor and unlock it.                                                                                                                                                                                                                |
| **Register Your Encryptor**   | The key is ready, but your public key is not published on this network yet. | Select **Register Encryptor** and confirm the transaction in your wallet.                                                                                                                                                                    |
| **Encryptor is Ready**        | Everything is set.                                                          | Nothing.                                                                                                                                                                                                                                     |

The widget checks the extension about every three seconds, so it updates on its own after you install, create or unlock.

## Steps

1. Look at the Encryptor widget on the dashboard.

{% hint style="info" %}
**Screenshot to capture:** `white-label--web--dashboard-encryptor--not-installed--light--1280.png`. Encryptor widget titled Get Encryptor Now with the Install Encryptor button.
{% endhint %}

2. Follow the action for the state it shows. After you create or restore a key, the widget moves on to the next state.

{% hint style="info" %}
**Screenshot to capture:** `white-label--web--dashboard-encryptor--locked--light--1280.png`. Encryptor widget titled Unlock Your Encryptor.
{% endhint %}

3. When it says **Register Your Encryptor**, select **Register Encryptor** and confirm in your wallet. Do this on a testnet first if you are trying the app out.
4. The widget shows **Encryptor is Ready**.

{% hint style="info" %}
**Screenshot to capture:** `white-label--web--dashboard-encryptor--ready--light--1280.png`. Encryptor widget titled Encryptor is Ready.
{% endhint %}

## Good to know

* Your public key is stored per network. If you switch network, you may need to register again.
* Encrypted mail and one-to-one chat need the **recipient** to have registered too. If they have not, the app tells you it cannot send encrypted content to them.
* Lost your Encryptor recovery phrase? The app cannot recover your key. See the Encryptor manual.

## Next

[Set up storage](https://wiki.4thtech.io/products/white-label/storage.md).
