> 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/mail.md).

# Send and read mail

Write, send, read, reply to and delete mail in BlockMail.

{% 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 %}

Mail contents go to your storage. The network records only a link and a checksum, so the recipient can check that nothing changed. If you use encryption, only you and the recipient can read the contents.

```mermaid
sequenceDiagram
  participant A as Sender app
  participant S as Storage (PollinationX)
  participant C as Mail contract (OCC v1)
  participant B as Recipient app
  A->>A: encrypt attachments and envelope
  A->>S: upload encrypted files and envelope JSON
  S-->>A: link to the stored envelope
  A->>C: record link and checksum
  C-->>B: new-mail event
  B->>S: fetch the envelope
  B->>B: verify checksum, decrypt
```

*Figure: How a mail is sent and read: the content goes to storage, the chain records the link and checksum, and the recipient fetches, verifies and decrypts.*

## Send a mail

1. Open **Mail**, then **Compose new**.
2. Turn **Use Encryption** on or off. It is on by default. With it on, the recipient must have registered with [Encryptor](https://wiki.4thtech.io/products/white-label/encryption.md). If they have not, the **Receiver** field shows an error and you cannot send encrypted mail to them.
3. Enter the recipient's address in **Receiver**, a **Subject** and your **Content**.
4. To attach files, drop them on the attachments area or choose files. The app shows upload progress per file.

{% hint style="info" %}
**Screenshot to capture:** `white-label--web--mail-compose--attachment--light--1280.png`. Compose form with receiver, subject, content and one attached file.
{% endhint %}

5. Select **Send**. Your wallet asks you to confirm the transaction. Try this on a testnet first.

{% hint style="info" %}
**Screenshot to capture:** `white-label--web--wallet-confirmation--mail-send-testnet--light--1280.png`. Wallet window asking to confirm sending a mail on a testnet.
{% endhint %}

6. The page shows **Your mail is on its way** and the transaction details. Select **Open explorer** to follow it, or **Compose new** to write another.

{% hint style="info" %}
**Screenshot to capture:** `white-label--web--mail-compose--transaction-details--light--1280.png`. Your mail is on its way page with transaction details.
{% endhint %}

If you leave the compose page with unsaved changes, the app asks you to confirm.

## Read your mail

1. Open **Mail**, then **Inbox**. New mail appears on its own.
2. Use the search box to filter the list. Select a mail to open it.

{% hint style="info" %}
**Screenshot to capture:** `white-label--web--mail-inbox--unread--light--1280.png`. Inbox list with one unread mail.
{% endhint %}

3. The mail opens at the right. Attachments are listed below the body; select one to download it.

{% hint style="info" %}
**Screenshot to capture:** `white-label--web--mail-detail--attachments--light--1280.png`. Opened mail with its list of attachments.
{% endhint %}

4. Use the toolbar on the mail to **Reply**, **Forward** or **Delete**. Reply and forward open the compose form with the subject and quoted text filled in. Delete is a transaction you confirm in your wallet.

## Sent mail

**Mail**, then **Sent** lists the mail you sent. It works like the inbox.

{% hint style="info" %}
**Screenshot to capture:** `white-label--web--mail-sent--list--light--1280.png`. Sent folder list with one sent mail.
{% endhint %}

## Who can mail you

You can limit who may send you mail. See [Choose who can mail you](https://wiki.4thtech.io/products/white-label/whitelist.md).
