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

# Bulk Email Sender

> Send personalized emails to Airtable records using a rich-text template with variable resolution and engagement tracking.

## What this tool does

The Bulk Email Sender sends personalized emails to recipients in your Airtable table. Each email is rendered from a template with that record's field values substituted in. Engagement data (opens, clicks, unsubscribes, bounces) is written back to Airtable fields you configure.

<Note>
  Each email successfully sent counts as **1 record processed** toward your plan limit. Recipients who are on your workspace's unsubscribe list or who have no valid email address are skipped and do **not** count. See [Billing](/docs/billing) for the full list of metered operations and how the cap is enforced.
</Note>

## Settings reference

### Source

| Setting            | Description                                                 |
| ------------------ | ----------------------------------------------------------- |
| **Source table**   | The table containing recipient records.                     |
| **Sender name**    | The display name shown in the From field. Default: "Filla". |
| **Reply-to email** | The address recipients can reply to.                        |

### Recipient mapping

| Setting                  | Description                                                                    |
| ------------------------ | ------------------------------------------------------------------------------ |
| **Email field**          | The field containing recipient email addresses.                                |
| **Recipient name field** | Optional. A field for the recipient's name, used to personalize the To header. |
| **Source view**          | Only send to records in this view.                                             |

### Tracking and compliance

| Setting                   | Description                                                                   |
| ------------------------- | ----------------------------------------------------------------------------- |
| **Open tracking**         | Track email opens via a tracking pixel. Default: enabled.                     |
| **Click tracking**        | Track link clicks. Default: enabled.                                          |
| **Unsubscribe link text** | Text for the unsubscribe link included in each email. Default: "Unsubscribe". |
| **Physical address**      | Your mailing address. Required by CAN-SPAM. Shown in the email footer.        |

### Status writeback

| Setting                   | Description                                                 |
| ------------------------- | ----------------------------------------------------------- |
| **Send status field**     | Tracks: Sent, Failed, or Pending.                           |
| **Sent at field**         | Date/time when the email was sent.                          |
| **Open timestamp field**  | Date/time when the email was opened.                        |
| **Click timestamp field** | Date/time when a link was clicked.                          |
| **Unsubscribe field**     | Boolean field. Marked true when the recipient unsubscribes. |
| **Bounce field**          | Text field for bounce type: hard or soft.                   |

### Email layout

| Setting         | Description                                                                                         |
| --------------- | --------------------------------------------------------------------------------------------------- |
| **Email width** | Max width of the email body: Narrow (480px), Standard (600px), Wide (700px), or Extra Wide (800px). |

## The template editor

The email template uses the same rich-text editor as the Document Generator. Type `@` to insert field values from the connected table. Both the subject line and body support variable references.

## Unsubscribe handling

The tool automatically checks a workspace-level unsubscribe list before sending. If a recipient's email is on the unsubscribe list (from a previous campaign), the email is skipped for that record.

When a recipient clicks the unsubscribe link:

* Their email is added to the workspace unsubscribe list
* The **Unsubscribe field** on their record is set to true
* Future sends to that address are blocked

## How emails are sent

Emails are sent via the Resend API from `noreply@inbox.filla.io`. Status writeback is batched in groups of 10 to respect Airtable's batch update limits.

<Warning>
  Bulk email sending is subject to your plan's sending limits. Ensure your physical address and unsubscribe link are included to comply with CAN-SPAM and similar regulations.
</Warning>

## Common questions

<AccordionGroup>
  <Accordion title="Can I send from my own email address or domain?">
    Not currently. Emails are sent from Filla's sending domain. The reply-to address can be set to your own email so replies come to you.
  </Accordion>

  <Accordion title="How is open tracking implemented?">
    A 1x1 transparent tracking pixel is embedded in the email. When the recipient's email client loads images, the pixel request is recorded as an open.
  </Accordion>

  <Accordion title="Can I send to a filtered subset of records?">
    Yes. Set a **Source view** in Airtable that filters to your target recipients. Only records in that view receive the email.
  </Accordion>

  <Accordion title="Can I preview the email before sending?">
    The template editor shows a live preview of the email template. Currently there is no "send test email" button. Preview the template carefully before running.
  </Accordion>

  <Accordion title="What happens if an email address in the record is invalid?">
    Delivery attempts to invalid addresses result in a bounce. The bounce type (hard or soft) is written to the Bounce field if configured.
  </Accordion>
</AccordionGroup>