> For the complete documentation index, see [llms.txt](https://docs.realmacsoftware.com/elements-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmacsoftware.com/elements-docs/using-elements/components/form/using-fastmail.md).

# Using Fastmail

Fastmail requires an [app-specific password](https://www.fastmail.help/hc/en-us/articles/360058752854) when the Form component connects to its SMTP service. Do not enter the password used to sign in to Fastmail.

{% hint style="info" %}
[Sign up for a Fastmail account](https://app.fastmail.com/signup/).
{% endhint %}

{% hint style="warning" %}
Fastmail Basic plans do not include SMTP access and cannot create app passwords. Use a plan that supports third-party email clients.
{% endhint %}

### Create an App Password

1. Open **Fastmail Settings → Privacy & Security**.

<figure><img src="/files/yRnalKSpKSfHVEPkC6Fe" alt="Fastmail settings showing password and security options"><figcaption><p>Open the password and security settings.</p></figcaption></figure>

2. Under **Connected apps & API tokens**, choose **Manage app passwords and access**, then **New app password**.

<figure><img src="/files/LaDzc5g9Z7sArgLLOp1b" alt="The New App Password option in Fastmail"><figcaption><p>Create a separate credential for the Elements form.</p></figcaption></figure>

3. Choose **Custom**, enter a recognisable name, give it Mail or SMTP access, and generate the password.

<figure><img src="/files/0vxHNPiGOHRmmx2UN63W" alt="Creating a custom SMTP app password in Fastmail"><figcaption><p>Limit the app password to SMTP access.</p></figcaption></figure>

4. Copy the generated password. Fastmail may show it only once.

<figure><img src="/files/KrdYcpwZZatGMXsJftiE" alt="A generated Fastmail app password ready to copy"><figcaption><p>Store the generated password securely.</p></figcaption></figure>

### Configure Form

In Form → Settings:

1. Keep Type set to Email.
2. Set Host to `smtp.fastmail.com`, Port to `465`, and Encryption to SSL. Alternatively, use Port `587` with TLS.
3. Enter the complete Fastmail email address as Username.
4. Paste the app-specific password into Password.
5. Use an address authorised by that Fastmail account as From Address.
6. Enter the recipient under To Address.

<figure><img src="/files/svQQ6wJu4TOk33Uoh2bO" alt="Fastmail SMTP details entered in the Elements Form component"><figcaption><p>Use the app password rather than the normal account password.</p></figcaption></figure>

Publish the site to a PHP-enabled server and complete a real submission. Forms cannot send from the normal local preview.

### Troubleshooting

If authentication fails:

* Confirm that the app password was created for SMTP.
* Remove accidental spaces before or after Username and Password.
* Confirm the Host, Port, and Encryption values against Fastmail’s current [server settings](https://www.fastmail.help/hc/en-us/articles/1500000278342-Server-names-and-ports).
* Make sure From Address is permitted by the authenticated account.
* Generate a new app password if the original was revoked or lost.

For additional help, post the error and relevant non-sensitive log details on the [Elements Forum](https://forums.realmacsoftware.com/). Never publish the app password.

### Related Documentation

* [Form](/elements-docs/using-elements/components/form.md) — Configures email delivery and server checks.
* [Submit](/elements-docs/using-elements/components/form/submit.md) — Adds the clickable control that sends the form.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.realmacsoftware.com/elements-docs/using-elements/components/form/using-fastmail.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.