Email settings

This section covers the settings for sending emails from your app through Bubble's built-in Sendgrid integration

This article explores using Bubble's built-in email features, which utilize Sendgrid. If you want to set up a more customized solution or prefer a different email API provider, consider configuring an API using the API Connector plugin or browsing the plugin store for plugins related to your desired provider.

Article: The API Connector plugin

Article series: Plugins

There are many scenarios in which you'll need to email the users of your app. Whether it's to notify them about updates, send password reset links, share promotional offers, or simply welcome them onboard, effective email communication enhances user engagement and trust in your platform.

Sending emails can be done sing the Send Email action. Some specific email types, such as resetting a user's password, has a built-in feature that generates a secure password reset token for you and can also automatically send the email.

Bubble offers two ways to send emails:

• Shared email address: if you haven't set up a custom domain and/or SendGrid account, Bubble offers a shared email address from which you can email your users. For apps in development, this solution is suitable. However, for live apps, we recommend using a dedicated SendGrid account to ensure email deliverability. The shared email address also has a limitation of 50 recipients per email.

• Custom domain: when you own a custom domain, you can customize SendGrid and Bubble's built-in email features use that domain instead. This is a more reliable solution for apps with live users.

When your app does not use a custom domain, all emails will come from [e-mail]. This is a shared email address from Sendgrid that comes out-of-the-box with your new Bubble app to help you get started.

In many scenarios you'll need to send an email to your users. This article covers the basic email settings needed to use Bubble's built-in email system.

Built-in email features

Bubble lets you send emails with customizable content, and additionally offers built-in features for sending more technically-oriented emails, such as those required for resetting a user's password.

Click on each point below for more information and links to their core reference entries:

Using the shared email address

If you have not yet connected your app to a custom domain, you can use Bubble's shared email address. What this means is that all your emails will come from the same address as other apps using the same feature:

[e-mail]

This is useful for when you are developing and testing your app, but we recommend setting up your own SendGrid account when your app goes live. You can read more about why and how to do that in the section below.

The built-in functionality for sending from the shared address comes out-of-the-box when your app is set up, and you don't need to make any changes to your app's settings. To send an email, simply use the feature in the workflow editor.

Limitations of using the shared email address

Using Bubble's shared email address comes with a few limitations:

• Due to rate limiting from SendGrid, a maximum of 50 recipients can be specified per email

• You can only send emails from the [e-mail] email address

• Measures such as is only available if you are managing your own SendGrid account

• SendGrid provides a range of features including custom email templates, tracking, analytics, and more. These are only available if you register your own account

• SendGrid keeps logs of all sent emails. The logs are only available if you register your own account.

Using a custom domain

Regardless of the email domain you want to use, Bubble's built-in email feature uses SendGrid to send emails. If you want to use your own and , you need to set up your own SendGrid account.

Setting up SendGrid

Before you set up your SendGrid account, you must own the domain that you want to use and connect it to your Bubble app. You can read more about registering our domain in the article below.

Article: Custom domain and DNS

Step 1: Creating a SendGrid account

The first thing you need to do is to register a SendGrid account at https://signup.sendgrid.com/.

Step 2: Generating an API key

After logging in, you need to get your API key from SendGrid (see SendGrid documentation here). Make sure to treat the API key as sensitive data and store it in a secure way.

Step 3: Set up and validate the key in Bubble

Navigate to Settings - Domain / Email and scroll down to the header that says Email settings. Note that if you have not yet connected your Bubble app to a domain, the setting will not be displayed.

Enter it in the input box in the SendGrid API Key field, and click on Verify Sendgrid Key. If your key is valid, a validation email will be sent to the account you used to sign up for Bubble.

Once you have validated your SendGrid connection, you will be able to, optionally, enter a template ID (so that all emails coming from your app follow a template you design in SendGrid).

You will also be able to modify the alias of the admin email.

Note that there are some things you can do on SendGrid's end to optimize email delivery, such as domain white-labeling, IP white-labeling, etc.

We recommend you read SendGrid's documentation for more details about their service.