# Connected account email configuration

Customize Stripe email communications to your connected accounts.

You can customize the emails that Stripe sends to your connected accounts and bulk-update their email addresses in your [Connect emails settings](https://dashboard.stripe.com/settings/connect/emails).

The emails settings page includes sections for different categories of emails, such as Stripe compliance emails, 1099 tax reporting emails, and tax document emails. Each section displays the number of each type of connected account that those emails apply to, for example: “Applies to 12 connected accounts who use the Express Dashboard.” You can open the Connected accounts page in a new tab, filtered to show the associated connected accounts, by clicking one of the numbers.

## Customize emails

You can customize the following elements of Stripe emails to your connected accounts:

- Appearance and branding
- The domain of the **From** address (the specific address [depends on the context of the email](https://docs.stripe.com/get-started/account/email-domain.md#supported-address-configurations))
- URLs of the pages hosting your Connect embedded components

1. In the section for the email type that you want to update, click **Preview and customize**.
1. To customize email branding, click **Customize branding** to open the **Branding** panel. Configure the panel settings, then click **Save**.
1. To have the **From** address use a [custom domain](https://docs.stripe.com/get-started/account/email-domain.md), click **Customize domain** to open the **Customer emails** tab of your Business settings page in a new browser tab.
1. To customize the URLs that host your Connect embedded components, click **Manage URLs** to open your Site links settings page in a new browser tab.
1. To preview a specific email with the updated settings, select an email type from the **Choose email to view** dropdown.
1. To send the preview email as a test, click **Send email** and enter the recipient address.
1. When you’re finished, click **Done**.

## Manage recipients

You can export, update, and import the recipient addresses for an email type, subject to the following restrictions:

- You must have the Administrator or Super Administrator [user role](https://docs.stripe.com/get-started/account/teams/roles.md).
- You must be in live mode. Attempting to export the address list in test mode or a sandbox results in an error.
- You can update a maximum of 100,000 email addresses at a time. If you need to update more than that, split the update into multiple files or use the API.

1. In the section you want to update, click **Manage recipients** to open the **Update email addresses** dialog.
1. Download a CSV file of the current recipients by clicking **Emails.csv**.
1. Edit the downloaded file with the updated email addresses.
1. Upload the updated file by clicking **Upload CSV** or dragging and dropping the file.
1. Verify the update by checking the data preview, then click **Confirm**.

The CSV file looks like this example:

```csv
Account ID,Business Name,First Name,Last Name,Email Address (please add or replace),User has claimed primary user email address
acct_123abc,Connected Account A,John,Doe,,✔
acct_123abc,Connected Account A,John,Doe,john.doe@example.com,✔
acct_456def,Connected Account B,Test,Smith,test@example.com,✗
acct_789ghi,Connected Account C,,,owner@example.com,✗
acct_012jkl,Connected Account D,,,,✗
```

Importing the CSV file only updates the email addresses. You can’t use it to edit any of the other properties.

> #### Account update webhooks
> 
> Bulk updating email addresses emits an event for every updated `Account`. If you have a webhook that listens for `Account` updates, expect a large amount of traffic following a bulk update.