# Newsletter

The Newsletter feature allows you to create and send email updates to donors at scale. Use it to draft donor updates, select an audience, personalize messages with donor merge tags, send the message immediately, or schedule it for later.

To navigate to newsletters, click **"Newsletters"** under **"Communications"** on the main menu.

![](/files/rZyzDVt3PZgLVUglbqHZ)

### Newsletters table

The Newsletters page lists the newsletters created for your account. At the top of the page, summary cards show the total number of newsletters and counts for drafts, scheduled newsletters, sent newsletters, and failed newsletters.

![](/files/0SNjxNzLxYwrCeqIDTNM)

The table shows the following details:

* **Title**: The newsletter title. Click the title to open the newsletter details page.
* **Status**: The current delivery status.
* **Scheduled For**: The scheduled delivery time. This is shown for scheduled newsletters.
* **Sender**: The administrator associated with the newsletter.
* **Date**: The date the newsletter was created.
* **Manage**: The available actions for that newsletter.

You can search newsletters by title and filter the table by status.

The newsletter statuses are:

* **Draft**: The newsletter has been saved and can still be edited, sent, scheduled, cloned, or deleted.
* **Scheduled**: The newsletter is scheduled to send later. It can still be edited or cancelled before it sends.
* **Sending**: The newsletter is being processed for delivery.
* **Sent**: The newsletter has finished sending.
* **Failed**: The newsletter did not finish sending. It can be retried, cloned, or deleted.

> **Note:** The **Sender** column shows the administrator associated with the newsletter. The email address and sender name used for delivery come from your account's [Email Settings](/guides/getting-started/quick-start-guide/email-settings.md) when configured.

### Creating a newsletter

To create a new newsletter, click **"New Email"** above the newsletter table.

Creating a newsletter has three steps: Compose, Recipients, and Preview.

### Step one: Compose

In the Compose step, add the newsletter title and build the email body in the editor.

![](/files/nhX0ESRZy6FigxhgBtKC)

You can also:

* Click **"Merge Tags Reference"** to view available donor merge tags. Click a tag to copy it, then paste it into the editor.
* Attach one file to the newsletter. Supported file types include JPEG, PNG, PDF, CSV, Word document, and Word Open XML document files. The maximum upload size is 10 MB.
* Click **"Save Draft"** to save the newsletter and return to the Newsletters page.
* Click **"Next"** to continue to recipient selection.

> **Note:** Merge tags may be unavailable if your account has no donor profile form configured, or if multiple donor profile forms are configured in a way that prevents a single donor merge-tag set from being used.

### Step two: Recipients

In the Recipients step, choose which donors should receive the newsletter.

![Screenshot placeholder: Newsletter recipients step with Select All Donors, Add by Tag, Add Individual Donors, and selected recipients table](/files/gwNGe3kMK4rvSAYtganc)

You can build the audience in three ways:

* **Select All Donors**: Select all donors with email addresses. Use **"Clear selection"** if you want to return to manual selection.
* **Add by Tag**: Select one or more tags to add donors who have those tags.
* **Add Individual Donors**: Search for donors by name or email address and add them one at a time.

Selected recipients appear in a table with display name, email address, and tags. You can search the selected recipients list and remove donors before sending or scheduling the newsletter.

When the audience is ready, click **"Preview"**.

### Step three: Preview and delivery

The Preview step shows the newsletter title, body, and attachment preview.

![Screenshot placeholder: Delivery options for sending immediately or scheduling for later](/files/qJQu0SYVZXMzSmteT4j5)

Under **"Delivery"**, choose one of the following options:

* **Send Immediately**: Queue the newsletter for delivery right away.
* **Schedule for Later**: Choose a timezone and scheduled time. Scheduled times must be at least 5 minutes in the future.

If you schedule the newsletter, HelpYouSponsor asks for the timezone and send time before the newsletter is saved as scheduled.

![](/files/qJQu0SYVZXMzSmteT4j5)

### Sending a saved draft

You can send or schedule an existing draft from the Newsletters table or from the newsletter details page.

From the table, click the **"Send now"** action on a draft newsletter. In the dialog, choose **"Send immediately"** or **"Schedule for later"**.

![Screenshot placeholder: Send Newsletter dialog with immediate and scheduled delivery options](/files/XZrvy2g9aOww1o4pRTIQ)

From the newsletter details page, click **"Approve & Send"** and choose the delivery option.

### Editing newsletters

To edit a draft or scheduled newsletter, click its title in the Newsletters table, then click **"Edit"** on the details page.

![Screenshot placeholder: Newsletter details page with Edit, Approve & Send, Clone, Email Overview, Audience, and Mailgun Log tabs](/files/CUerDhClKDhcBcz3IEmt)

Draft and scheduled newsletters can be edited before they are sent. You can update the title, message, attachment, and audience. For scheduled newsletters, you can also update the scheduled time and timezone.

The details page includes these tabs:

* **Email Overview**: Preview the newsletter. In edit mode, update the content and attachment.
* **Audience**: Review recipients. For draft and scheduled newsletters, edit the audience by adding donors, adding tags, or removing recipients.
* **Sent**: After a newsletter is sent, this tab shows the donors it was sent to.
* **Mailgun Log**: Shows Mailgun event logs when they are available for your account.

### Cancelling or retrying delivery

Scheduled newsletters can be cancelled before they are sent. Click the **"Cancel schedule"** action in the Newsletters table. The newsletter returns to **Draft** status.

Failed newsletters can be retried from the Newsletters table. Click the **"Retry"** action to queue the newsletter for delivery again.

### Cloning a newsletter

You can clone a newsletter from the Newsletters table or from the newsletter details page. Cloning always creates a new draft so you can review it before sending.

![Screenshot placeholder: Clone Newsletter drawer with title field and clone scope options](/files/w5fG002zNVhHIvXxaN7e)

When cloning, choose what to copy:

* **Everything**: Copies the template, design, attachment, and audience.
* **Template only**: Copies the design, message, attachment, and sender information. The audience is empty.
* **Audience only**: Copies the recipients and audience selection. The message template is empty.

After the newsletter is cloned, HelpYouSponsor opens the new draft so you can edit, send, or schedule it.


---

# Agent Instructions: 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:

```
GET https://docs.helpyousponsor.com/guides/core-features/communication-tools/newsletter.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
