Download the Brevo plugin for WordPress

The Brevo plugin for WordPress lets you connect your site with Brevo and manage key features directly from your WordPress dashboard, including creating static or pop-up sign-up forms, syncing subscribers, and sending web push notifications.

About the Brevo plugin for WordPress

Learn more about the plugin’s features, use cases, and limitations in the following tabs:

Before you start

Before installing the Brevo plugin for WordPress, make sure you have:

• A Brevo account
• Your Brevo API v3 key
• Your WordPress website admin access

Install the plugin

To install the Brevo plugin on your WordPress site:

1. Log into the admin dashboard of your WordPress site.
   
   💡 Good to know

   To access admin dashboard of your WordPress site, enter your site URL in your browser, followed by /wp-admin (for example, the-green-yoga.com/wp-admin or the-green-yoga.wordpress.com/wp-admin).
2. In the sidebar menu, go to Plugins > Add New Plugin.
   
3. Search for Brevo.
4. Next to the "Newsletter, SMTP, Email marketing and Subscribe forms by Brevo" plugin, click Install Now.
   
5. Click Activate.
6. In the sidebar menu, go to Brevo > Home.
   
7. Under Activate your account with your API key v3, enter your Brevo API key. You can create an API key on the SMTP & API page in Brevo. To learn more, check our dedicated article Create and manage your API keys.
8. Click Login.
   

You have successfully installed the Brevo plugin for WordPress and connected it with your Brevo account.

Sync your WordPress contacts to Brevo

Sync your WordPress users and subscribers to Brevo. This includes:

1. Manually syncing existing contacts already stored in WordPress, and 
2. Defining how new contacts are added to Brevo.

Step 1: Manually sync your existing WordPress contacts to Brevo

The initial sync of existing WordPress contacts (added before installing the plugin) must be done manually by selecting which user roles to sync to a specific Brevo list. If you want to sync different roles to different lists, you will need to repeat the process for each list.

To manually sync your existing WordPress contacts to Brevo:

1. In the sidebar menu, go to Brevo > Home.
2. Click Sync my users.
   
3. In the Users Synchronisation window, select:
   1. The user roles you want to sync.
   2. The Brevo list(s) where the contacts should be added.
   3. The user attributes you want to sync.
      
      💡 Good to know

      Only the fixed set of default WordPress user attributes available in the dropdown can be synced. Custom attributes are not supported.
      
4. Click Apply.
5. Repeat the process to sync different roles to other lists.

Your existing contacts have been synced to Brevo.

Step 2: Sync your new WordPress contacts to Brevo

After syncing your existing contacts, configure how new WordPress contacts are added to Brevo. New contacts can be added to Brevo automatically based on how they interact with your site. 

There are two ways this can happen ⬇️:

Add a sign-up form to your WordPress site

Sign-up forms let visitors subscribe to your emails directly from your WordPress site. When a visitor submits a form, they are added to a list in Brevo and subscribed to receive your emails.

Using a sign-up form allows you to collect explicit opt-in consent and trigger automations based on form submissions.

Brevo offers two types of sign-up forms for WordPress: 

• Static sign-up form
  A form embedded directly on a page or post. You can create it in Brevo or through the Brevo plugin for WordPress.
• Pop-up sign-up form
  A responsive form displayed based on triggers, such as a delay, exit intent, or selected pages.

Static sign-up forms

A static sign-up form is a standard form that is permanently displayed on your WordPress site. You can embed it on a page, post, sidebar, or footer. Static forms are ideal if you want a visible and always-available subscription option.

You can create and add a static sign-up form to your WordPress site using one of the following methods:

• [Recommended] Method 1: Create the form in Brevo
  Create the sign-up form directly in Brevo and embed it on your WordPress site using an iframe. This method helps avoid conflicts with WordPress themes or third-party plugins.
• Method 2: Create the form using the Brevo plugin
  Create a static sign-up form through the Brevo plugin and embed it using a shortcode.

Use the following tabs to learn how each method works ⬇️:

Method 1: Create a static form in BrevoMethod 2: Create a static form through the Brevo plugin

Create a static sign-up form in Brevo and embed it as an iframe on your WordPress site:

1. Create a static sign-up form in Brevo. To learn more, check our dedicated article Create a sign-up form in Brevo.
   
2. At the Share step of the form creation process, copy the iframe code generated by the form builder.
   
3. In WordPress, create or open a page or post where you want to add your form.
4. In the page or post, type /html on a new line and press Enter to add a new Custom HTML block.
   
5. Paste the iframe code into the field.
   
6. (Optional) Click Preview to see how the form will appear on the page or post.
7. Save and publish the page or post.

Create a static sign-up form directly through the Brevo plugin and embed it on your WordPress site using a shortcode:

Step 1: Create a sign-up form

1. In the sidebar menu, go to Brevo> Forms.
2. Click Add New Form.
   
3. In the Form name field, enter the internal name of the form.

Step 2: Update the form content

Add or remove fields from the form to choose which information you want to collect from your contacts.

Use the following dropdowns to learn how to update the form content ⬇️:

Add a new field

To add a new field to the form:

1. From the Add new Field dropdown, select the type of field (e.g., FIRSTNAME, EMAIL) that matches the data you want to collect. The available fields are based on the contact attributes set up in your Brevo account.
   
2. Fill in the details for each field, including:
   • Label: The name or description of the field (e.g., "First Name").
   • Placeholder: Text displayed inside the field to guide the user (e.g., "Enter your first name").
   • Initial Value: Pre-filled data, if applicable.
   • Required field: Specify whether the field is mandatory to complete before submission.
3. Click Add to form to add the new field to the form and preview the changes. The new field will appear inside the opening tag <p> and closing tag </p>.
   
4. Repeat steps 1 to 3 for each field you want to add to the form.

Remove a field

To remove a field:

1. In the HTML editor, locate the section of code for the field you want to remove.
2. Select the text starting with <p> and ending with </p>.
   
3. Delete the selected text.
4. In the preview, click the 🔁 refresh icon to ensure the form still displays correctly after the change.

Update the Subscribe button

To update the value of the Subscribe button:

1. In the HTML editor, locate the following section of code:
   

   <input type="submit" class="sib-default-btn" value="Subscribe">

2. Replace Subscribe with the text you want to display on the button and make sure you keep the quotation marks around the text. For example:
   

   <input type="submit" class="sib-default-btn" value="Yes, I want to subscribe">

Step 3: Customize the form

Customize the form by activating the following options:

Multi-List Subscription: Allow subscribers to select their preferences and be added to corresponding lists. Compliance Note: Inform contacts that their email address will be used for newsletters and brand updates, with an unsubscribe option included in every email. CAPTCHA: Protect your form from bots by adding a verification step. Checkbox: Let contacts agree to your terms and conditions before submitting the form. Custom Style: Retain your current theme or use CSS to customize the appearance of your sign-up form.

Step 4: Configure the sign-up process

Configure the sign-up process for contacts who submit the form:

1. Linked list: Choose which list(s) contacts will be added to after they submit the form.
   
   💡 Good to know

   If you use the Multi-list subscription option, you can select a default list from the Linked list option where all contacts will be added.
2. Send a confirmation email: Send an email confirming their subscription.
3. Double opt-in: Set up a double opt-in process to require contacts to click a link in the confirmation email to validate their subscription.
4. Redirect to this URL after subscription: Redirect contacts to a specific page (e.g., a thank-you page) after submission.

Step 5: Edit your confirmation message

Customize the text for success and error messages that appear on your sign-up form after submissions:

Step 6: Retrieve the shortcode of the form

Before sharing your sign-up form on your website, retrieve its shortcode:

1. In the sidebar menu, go to Brevo > Forms. Here, you will find a list of all the forms you have created, along with their respective shortcodes.
2. Copy the shortcode of the sign-up form you want to add to your website.
   

Step 7: Add the sign-up form to your WordPress site

You can place your sign-up form in multiple locations on your WordPress site, including individual pages, the sidebar, or the footer.

Use the following dropdowns to learn how to place your sign-up form in different locations ⬇️:

Place the form in the sidebar or footer

To place your form in the sidebar or footer of your website:

1. In the sidebar menu, go to Appearance > Editor.
2. Navigate to the footer of your website and select it.
3. At the top-left, click +.
   
4. From the Blocks tab, select the Shortcode widget. It will be automatically added at the bottom of the footer.
   
5.  Paste the shortcode of your sign-up form in the empty field.
   
6. Once you're done, click Save.

Your static sign-up form has been added to your WordPress site and new contacts can start subscribing.

Place the form in individual pages

To place your form in individual pages of your website:

1. In WordPress, create or open a page or post where you want to add your form.
2. Paste the shortcode where you want to add your form.
   
3. Click Save.

Your sign-up form will be added to your website and your contacts can start subscribing.

Pop-up sign-up forms

A pop-up sign-up form appears based on specific triggers, such as after a delay, on exit intent, or on selected pages. It helps capture attention without permanently displaying a form on the page.

To add a pop-up sign-up form to your WordPress site:

1. Install the Brevo tracker on your WordPress site. 
2. Create a pop-up sign-up form in Brevo. To learn more, check our dedicated article Create a pop-up sign-up form in Brevo.

Use Brevo SMTP for your WordPress transactional emails

Using Brevo SMTP with the WordPress plugin lets you send transactional emails, such as password resets and comment notifications, directly through Brevo. This also allows you to authenticate your domain, which helps improve your reputation and reduces the chance that your emails will end up in spam.

To use Brevo SMTP for your WordPress transactional emails:

1. In the sidebar menu, go to Brevo > Home.
2. Under Transactional emails, select Yes to activate emails through Brevo. 
   
   ❗️ Important

   If you see the error message: "Unfortunately, your 'Transactional emails' are not activated because your Brevo SMTP account has not been activated", contact our support team by creating a ticket from your account to request activation of your SMTP account.
3. Choose an existing sender or create a new one. All emails will be sent using this sender name and email address.
4. Enter an email address to send a test email.
   
5. Click Send email to receive your test email.

Install the Brevo tracker on your WordPress site

To install the Brevo tracker on your WordPress site:

1. In the sidebar menu, go to Brevo > Home.
2. Under Automation, select Yes to activate the Marketing Automation through Brevo option.
3. Click Activate.

➡️ To learn more, check our FAQ article What is the Brevo tracker and how to install it?.

Send web push notifications

Push notifications are short messages that appear directly on a user's device, even when they're not on your website. They're a great way to re-engage visitors, share updates, and drive traffic back to your WordPress site in real time.

Step 1: Activate web push notifications

To send web push notifications to your website visitors, first activate the Web Push option through the plugin's settings:

1. In the sidebar menu, go to Brevo > Home.
2. Under Web push, click Activate.
   

Step 2: (Optional) Create new contacts in Brevo for each push subscriber

By default, you can only send push notifications from your website using the Brevo plugin for WordPress.

If you also want to target your web push subscribers through automations and campaigns in Brevo, you can choose to create a contact for them in Brevo when they subscribe. This applies to both anonymous and identified subscribers.

To create a new contact in Brevo for each push subscriber:

1. In the WordPress sidebar, go to Brevo > Web push.
2. From the Settings tab, click Advanced Settings.
   
3. Check the Create Brevo contacts from push notification subscribers option.
   
4. Click Save.

When someone subscribes to web push notifications on your website, Brevo will now create a contact for them.

Step 3: Manage your default pressure settings

Pressure control helps you manage how and when push notifications are sent. It allows you to:

• Control delivery speed to avoid sending too many notifications at once, which could overload your server.
• Limit the number of notifications per user within a given timeframe (hourly, daily, or weekly).

By default, users can receive up to 10 notifications per day. This limit applies to both blog notifications and push campaigns. You can adjust it and set a default delivery speed for your notifications.

1. In the sidebar menu, go to Brevo > Web push.
2. From the Settings tab, click Pressure settings.
   
3. Under Subscriber protection, change the default limit of notifications a user can receive. You can also create or update the limit by category.
   
4. Under Delivery speed, select the default delivery speed for your push notification.
5. Click Save.

Step 4: Send your push notifications

You can then choose to send two different types of push notifications:

• Automatically notify subscribers when you publish a new blog post
• Create and send a targeted web push campaign at the time of your choice

Use the following tabs to view instructions for each option ⬇️:

Deactivate web push notifications

To stop new subscriptions and prevent web push notifications from being sent, you can deactivate the Web Push option through the plugin's settings:

1. In the sidebar menu, go to Brevo > Home.
2. Under Web push, click Turn off web push.
   
3. Click OK.

Chat with your website visitors

Brevo Conversations lets you connect with your leads and customers in real-time on your website.

To install a chat widget on your WordPress site:

1. Install the Brevo tracker on your WordPress site. 
2. Log in to Brevo.
3. Click the account dropdown and select Settings > Inbox.
4. Next to Chat widget, click Set up.
5. Click Install chat widget.
6. Set up your chat widget and profile settings. To learn more about the customization of your chat widget or profile, check our dedicated articles Customize your chat widget appearance and Set up your chat profile.
7. Click Add the chat widget to your website(s).

Uninstall the plugin

If you no longer want to use the WordPress plugin or encounter issues with it, you may need to uninstall it.

1. Log into the admin dashboard of your WordPress site.
   
   💡 Good to know

   To access the admin dashboard of your WordPress site, enter your site URL in your browser, followed by /wp-admin (for example, the-green-yoga.com/wp-admin or the-green-yoga.wordpress.com/wp-admin).
2. In the sidebar menu, go to Plugins > Installed Plugins.
3. Next to the Brevo plugin named "Newsletter, SMTP, Email marketing and Subscribe forms by Brevo", click Deactivate and Delete.

You have uninstalled the Brevo plugin from your WordPress site. To reinstall it, check our dedicated section in this article.

Troubleshoot issues with the plugin

If you are experiencing issues with the Brevo plugin for WordPress, we recommend you review the following troubleshooting tips before contacting our support team.

Select the issue that best matches your situation:

API key does not work

You cannot activate the Brevo plugin using your API key. You may see one of the following error messages:

• "Please input a valid API v3 key"
• "Unauthorized: Key not found"

Common causes and solutions

Verify the fix

After activating the plugin with the API key, confirm that your Brevo account information appears in the plugin dashboard:

If the issue persists, contact our support team and include a screenshot of the error message.

Existing contacts are not synchronized to Brevo

Existing WordPress contacts are not syncing to Brevo when clicking Apply. You may see the following error message at the bottom-left of your screen: "javascript:void(0)".

Common cause and solution

Verify the fix

In Brevo, go to Contacts and confirm that your WordPress contacts are now listed.

If you cannot identify the conflicting plugin, contact our support team. Include a list of your active plugins and a screenshot of the error.

Sign-up form is not displayed or displays incorrectly

Your sign-up form does not appear on your website or it looks broken. You may see a white page with an error message when submitting the form.

Common causes and solutions

The HTML of a Brevo form was pasted directly into the plugin’s form builder

Pasting the HTML code of a Brevo form directly into the plugin’s form builder can break how the form is displayed.

Solution: Recreate the form in Brevo or through the plugin settings using one of the methods explained in this article.

You have made changes to the HTML code of the form

When editing the HTML code of a form created through the plugin's settings, do not modify the class attribute. 

The class attribute should keep its original format: sib-xxx-area (e.g., sib-email-area).

Default form (works)	Modified form (does not work)

Solution: Update the form with the correct class attribute, or recreate it from scratch as explained in this article.

A WordPress theme or third-party plugin is conflicting

Another WordPress plugin or your theme may cause a conflict. This usually happens if, after submitting a form created through the plugin’s settings, you are redirected to a blank white page showing this message:

{"status":"new","msg":{"successMsg":"Thank you, you have successfully registered !","errorMsg":"Something wrong occured","existMsg":"You have already registered","invalidMsg":"Your email address is invalid"},"redirect":""}

Solution: Temporarily deactivate other plugins one at a time. After deactivating a plugin, try submitting the form. If the issue persists, switch to a default WordPress theme and test the form again.

If the form works after a change, that plugin or your theme is likely causing the conflict. Reactivate all other plugins and your original theme after testing.

Verify the fix

Clear your website and browser cache. Reload the page where the form is displayed and submit the form using a test email address. Confirm that the form displays correctly and that the contact is added in Brevo.

If the issue persists, recreate the form using one of the methods explained in this article and add it again to your page, or contact our support team with screenshots and details of the steps you tried.

reCAPTCHA error occurs when submitting a form

Your Brevo form with reCAPTCHA does not work, and you may see one of these errors when trying to subscribe:

• "ERROR for site owner: Invalid domain for site key"
• "ERROR for site owner: Invalid key type"

Common causes and solutions

Verify the fix

Open the form in an incognito window and submit a test subscription. Confirm the error no longer appears and the contact is saved in Brevo.

If the error persists, contact our support team and include the form URL, a screenshot of your Google reCAPTCHA domain settings, and a screenshot of the error message.

New contacts are not added after submitting a sign-up form

New contacts are not being added to your Brevo account after submitting a sign-up form on your WordPress site. You may notice one or more of the following behaviors:

• The form submits successfully, but the contact does not appear in Brevo.
• The form works for a few days and then stops adding contacts.
• The form only works after clearing the website cache.
• The form loads slowly or displays random errors.

Common causes and solutions

Verify the fix

Submit the form using a test email address and confirm that the contact appears in your Brevo contact list.

If the problem persists, contact our support team and include the form URL, the caching or optimization plugins in use (if applicable), and whether the issue is consistent or intermittent.

Brevo SMTP cannot be activated

Brevo SMTP cannot be activated in the WordPress plugin. You may see an error message when activation SMTP or when saving the plugin settings.

Verify the fix

Activate Brevo SMTP and send a test email. Verify that the email was received correctly.

If the problem persists, contact our support team and include the error message you see (if applicable).

Emails are not sent correctly through Brevo SMTP

Emails are sent through Brevo SMTP, but they are not delivered as expected. This may include incorrect sender details or delivery issues.

Verify the fix

Send a test email from WordPress using Brevo SMTP and confirm that the sender name and email address are correct. Verify that the email is delivered successfully and not marked as spam.

If the issue continues, contact our support team and include the sender email address and the error details (if any).

⏭️ What's next?

• Brevo plugin for WooCommerce - Sync your store and automate your marketing

🤔 Have a question?

If you have a question, feel free to contact our support team by creating a ticket from your account. If you don't have an account yet, you can contact us here.

If you’re looking for help with a project using Brevo, we can match you with the right certified Brevo Agency partner.