> For the complete documentation index, see [llms.txt](https://wiki.beabee.io/help-center-english/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.beabee.io/help-center-english/other/sending-bulk-emails-with-beabee.md).

# Sending bulk emails with beabee

If you want to send the same email to multiple recipients while personalising parts of the content—such as the greeting, name, or specific sections of text—you can do this with beabee. All you need is your email content and a CSV file containing your recipients' email addresses, names, and any other information you want to insert into the email using Merge Fields.

This feature is ideal when you want to customise certain parts of an email for different groups of recipients. For example, you can invite recipients who haven't subscribed to your newsletter yet to sign up at the end of the email, while thanking existing subscribers for their support. You can also personalise content based on location by automatically inserting the recipient's city, neighbourhood, or other relevant information.

***

## How it works

{% stepper %}
{% step %}
Log in to your beabee instance and click *Old dashboard* in the left-hand navigation. Then go to *Tools* and *Emails*.

<figure><img src="/files/bwoO0hDgrBctDcCYdMfN" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
On this page, you'll find a list of all emails that have already been created in your instance. Scroll to the bottom of the page to create a new email.

Fill in the following fields:

* Email name
* Sender email address
* Sender name
* Subject
* Email content

If you want to personalise parts of the email for each recipient, use merge tages. Merge Fields use the following format: \*|MERGEFIELD|\*. For example:

* \*|FNAME|\* for the recipient's first name
* \*|STATE|\* for their state or region
* \*|SIGNOFF|\* for a custom closing message

You can choose any Merge Field name you like.

When you're finished, click *Create* to save the email.

<figure><img src="/files/xmmsAxAZS7PLbdxCQq4i" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
After saving the email, scroll down to the *One-off mailings* section.

<figure><img src="/files/rOo5ndf5So28Okvsej38" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Here, you can upload a CSV file containing your recipients.

Your CSV file should include one column for each Merge Field you want to use. It must also include at least the recipients' email addresses, first names, and last names.

A sample CSV file might look like this:

| Email Address      | First Name | Last Name | State             |
| ------------------ | ---------- | --------- | ----------------- |
| <svenja@email.com> | Svenja     | Schlange  | Baden-Württemberg |
| <anja@email.com>   | Anja       | Amsel     | Hamburg           |
| <tobias@email.com> | Tobias     | Taube     | Saxony            |
| {% endstep %}      |            |           |                   |

{% step %}
Once you've uploaded your CSV file, click *Preview*.

<figure><img src="/files/n5azLg6Y4X0lKyVo8E93" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Next, map each Merge Field to the corresponding column in your CSV file. This ensures that the values from your CSV are automatically inserted into the correct Merge Fields when the email is sent.

<div><figure><img src="/files/HLfJN9H66M05zKdtAoCI" alt=""><figcaption></figcaption></figure> <figure><img src="/files/XckDVtsQozL5qGF2xFlT" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Use the preview to verify that all Merge Fields have been replaced with the correct values from your CSV file. If everything looks correct, check the *Ready to send?* box and click *Send* to send the emails.

<figure><img src="/files/FPT8Iwzw0oNSx19tVxMP" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Done! Every contact in your CSV file will receive a personalised version of your email with the appropriate content inserted automatically.
{% endstep %}
{% endstepper %}

***

<p align="center"><strong>Missing a guide or need support? Let us know!</strong></p>

<p align="center"><a href="mailto:support@beabee.io" class="button primary" data-icon="envelope">Email us</a>oder<a href="https://community.beabee.io/crowdnewsroom/guide-request" class="button primary" data-icon="lightbulb">Suggest a guide</a> </p>
