The Brevo plugin for WordPress (Newsletter, SMTP, Email Marketing, and Subscribe Forms) allows you to easily integrate your WordPress website with Brevo. With the plugin, you can create sign-up forms to grow your contact lists, manage the sending of transactional emails, track your page visits, and more, directly from your WordPress account.
Install and connect the WordPress plugin
First, install the WordPress plugin and connect it to your Brevo account.
- Log in to your WordPress website's admin dashboard.
💡 Good to knowYou can access your WordPress website's admin dashboard by entering your website address in your browser's address bar, followed by/wp-admin
(e.g.,the-green-yoga.com/wp-admin
orthe-green-yoga.wordpress.com/wp-admin
). - In the sidebar menu, go to Plugins > Add New Plugin.
- In the search bar, type
Brevo
. - Next to the Brevo plugin named "Newsletter, SMTP, Email marketing and Subscribe forms by Brevo", click Install Now.
- Click Activate.
- In the sidebar menu, go to Brevo > Home.
- Under Activate your account with your API key v3, enter your 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.
- Click Login.
You have successfully installed the Brevo plugin for WordPress and connected it to your Brevo account. You can now use the plugin to synchronize your contacts, create sign-up forms, and more ⬇️.
Sync your existing WordPress contacts with Brevo
Syncing your existing WordPress contacts (those you had before installing the plugin) with Brevo is not automatic and needs to be done manually through the plugin's settings the first time.
- In the sidebar menu, go to Brevo > Home.
- Click Sync my users.
- In the Users Synchronisation window, select:
- The user roles you want to sync.
- The Brevo list(s) where the contacts should be added.
- The attributes you want to sync.
- Click Apply.
Your existing WordPress contacts have been synchronized with Brevo. You can now sync your new WordPress contacts ⬇️.
Sync your new WordPress contacts with Brevo
After synchronizing your existing WordPress contacts, you can start syncing new WordPress contacts with Brevo in real time. When a new contact is created in WordPress, it will be automatically added to Brevo. However, updates, deletions, or blocklisting of contacts will not be synchronized.
There are two methods available to sync your new WordPress contacts:
- Using the Brevo tracker: Identify new contacts using the Brevo tracker.
- Through a form: Allow contacts to subscribe through a form.
Use the following tabs to view instructions for each method:
The Brevo tracker is a tracking code you can add to your website to monitor activity in real-time. It uses first-party or third-party cookies to collect data about your visitors and their actions, such as visiting specific pages, and sends this information directly to Brevo.
Your WordPress contacts will be identified by the Brevo tracker, and their email addresses will be added to the "identified_contacts" list in Brevo when:
- They create an account on your website.
- They complete a purchase on your website without logging in to an account (guest mode).
- They submit a sign-up form created in Brevo or through the WordPress plugin.
To learn how to install the Brevo tracker on your website through the plugin's settings, check our dedicated section Track the page visits on your website.
Only their email addresses will be retrieved. These contacts will not be automatically subscribed to receive your emails.
Contacts who submit a form created in Brevo or through the WordPress plugin will be automatically synchronized to Brevo. They will be added to the list you selected during the form setup, and the information they submit through the form will be synchronized to their profile. These contacts will also be automatically subscribed to receive your emails.
To learn how to add a sign-up form on your WordPress website, check our dedicated section Add a sign-up form to your WordPress website.
Add a sign-up form to your WordPress website
Copying and pasting the code of a Brevo form into the WordPress form builder (and vice versa) can cause issues with your sign-up form. To ensure proper functionality, you need to re-create your forms using one of the methods outlined below.
When a contact submit a form on your WordPress website, they will be added to a specific list in Brevo and subscribed to receive your emails. This also provides proof of their opt-in consent and allows you to trigger automations based on form submissions.
We offer two methods to create a sign-up form for your WordPress website:
- Using Brevo: Create the form in Brevo and embed it on your website as an iframe [Recommended]
- Using the WordPress plugin: Create the form directly through the plugin's settings and embed it using a shortcode.
Use the following tabs to view instructions for each method:
After creating a sign-up form in Brevo, you can embed as an iframe on your WordPress website:
- Create a sign-up form in Brevo. To learn more, check our dedicated article Create a full page/embedded sign-up form in Brevo.
- At the Share step of the form creation process, copy the iframe code generated by the form builder.
- In WordPress, create or open a page or post where you want to add your form.
- In the page or post, type
/html
on a new line and press enter to add a new Custom HTML block. - Paste the iframe code into the field.
- (Optional) Click Preview to see how the form will appear on the page or post.
- Save and publish the page or post.
You can create a sign-up form directly on WordPress through the plugin's settings and embed it using a shortcode:
Step 1: Create a sign-up form
- In the sidebar menu, go to Brevo > Forms.
- Click Add New Form.
- 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.
Add a new field
To add a new field to the form, select the field you want to include.
- 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.
- 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.
- 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>.
- Repeat steps 1 to 3 for each field you want to add to the form.
Remove a field
To remove a field, delete the corresponding HTML code for that field.
- In the HTML editor, locate the section of code for the field you want to remove.
- Select the text starting with <p> and ending with </p>.
- Delete the selected text.
- 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:
- In the HTML editor, locate the following section of code:
<input type="submit" class="sib-default-btn" value="Subscribe">
- 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:
|
Step 4: Configure the sign-up process
Configure the sign-up process for contacts who submit the form:
-
Linked list: Choose which list(s) contacts will be added to after they submit the form.
💡 Good to knowIf you use the Multi-list subscription option, you can select a default list from the Linked list option where all contacts will be added. - Send a confirmation email: Send an email confirming their subscription.
- 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.
- 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 form's shortcode
Before sharing your sign-up form on your website, retrieve its shortcode:
- 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.
- Copy the shortcode of the sign-up form you want to add to your website.
Step 7: Share the form on your website
You can share your in different places on your website:
- Add the form on individual pages of your website.
- Add the form on the sidebars or footer of your website.
Option 1: Add the form on individual pages of your website
To add your form on individual pages of your website:
- In WordPress, create or open a page or post where you want to add your form.
- Paste the shortcode where you want to add your form.
- Click Save.
Your sign-up form will be added to your website and your contacts can start subscribing.
Option 2: Add the form on the sidebars or footer of your website
To add your form to your website’s sidebars or footers:
- In the sidebar menu, go to Appearance > Editor.
- Navigate to the footer of your website and select it.
- At the top-left, click +.
- From the Blocks tab, select the Shortcode widget. It will be automatically added at the bottom of the footer.
- Paste the shortcode of your subscription form in the empty field.
- Once you're done, click Save.
Your subscription form has been added to your website and visitors can start subscribing to your newsletter.
Send transactional emails from WordPress using Brevo SMTP
With the WordPress plugin, you can set Brevo as your primary SMTP provider to send transactional emails directly through Brevo based on actions occurring on your website.
To send your transactional emails using Brevo SMTP:
- In the sidebar menu, go to Brevo > Home.
- Under Transactional emails, select Yes to activate emails through Brevo.
❗️ ImportantIf 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. - Choose an existing sender or create a new one. All emails will be sent using this sender's ,ame and email address.
- Enter an email address to send a test email.
- Click Send email to receive your test email.
Track the page visits on your website
To track the page visited by contacts on your website, activate the Activate Marketing Automation through Brevo option through the plugin's settings. This will automatically install the Brevo tracker on your website. To learn, more check our dedicated article FAQs - What is the Brevo tracker and how to install it?.
- In the sidebar menu, go to Brevo > Home.
- Under Automation, select Yes to activate Marketing Automation through Brevo.
- Click Activate.
The Brevo tracker will be automatically installed on your website and you'll be able to create automations based on page visits.
Chat with your customers
Brevo Conversations lets you connect with your leads and customers in real-time on your website and from other communication channels such as Facebook Messenger or Instagram Direct. Conversations offers new features such as chatbot, targeted chats, mobile apps, or saved replies to help you sell more online. To discover the Conversations app, check our dedicated article Change the way you communicate with your customers. |
Monitor your statistics
You can track your statistics and analyze the performance of your email and SMS campaigns, such as opens, clicks, unsubscribes, and bounces, directly through the plugin's settings.
- In the sidebar menu, go to Brevo > Statistics.
- Select a time period.
- Click Apply.
Uninstall the WordPress plugin
If you no longer want to use the WordPress plugin or encounter issues with it, you may need to uninstall it.
- Log in to your WordPress website's admin dashboard.
💡 Good to knowYou can access your WordPress website's admin dashboard by entering your website address in your browser's address bar, followed by/wp-admin
(e.g.,the-green-yoga.com/wp-admin
). - In the sidebar menu, go to Plugins > Installed Plugins.
- Next to the Brevo plugin named "Newsletter, SMTP, Email marketing and Subscribe forms by Brevo", click Deactivate and Delete.
Troubleshoot issues with the WordPress plugin
My API key is not working
If you encounter the error message Please input a valid API v3 key
or Unauthorized:
Key not found
when trying to connect the WordPress plugin to Brevo, it could mean one of the following:
- You are pasting an incomplete API key with only the last six digits.
- You are using an API v2 key instead of an API v3 key.
- You are mistakenly using an SMTP key.
To resolve this issue, go to SMTP & API page, generate a new API key, and copy-paste it into the plugin's settings.
My existing contacts are not synchronized with Brevo
If when clicking the Apply button to sync your existing contacts, nothing happens and an error javascript:void(0)
appears at the bottom-left side of your screen, it means there might be a conflict with another third-party plugin on your WordPress website.
To resolve this issue, try deactivating the plugins on your website one by one to identify the conflict that may be blocking the sync. If the error persists, contact our support team by creating a ticket from your account.
My new contacts are not added to Brevo after submitting a sign-up form
If new contacts are not being added to Brevo after submitting a sign-up form, ensure that the form was created in Brevo or through the plugin's settings. Forms created using the native WordPress editor or third-party tools will not add new contacts to Brevo.
To resolve this issue, recreate your form in Brevo or through the plugin's settings.
Embedding the same form multiple times on a single page can cause issues as it duplicates the HTML code and the same values are being reused.
To resolve this issue, create separate forms in Brevo and embed each one individually on the page.
If you encounter issues with forms when multiple separate forms are embedded on the same page, it means there might be a conflict with another third-party plugin or WordPress theme on your WordPress website.
To resolve this issue, create separate forms in Brevo and embed each one individually on the page.
Copying and pasting the code of a Brevo form into the WordPress form builder (and vice versa) can cause issues with your sign-up form. To ensure proper functionality, you need to re-create your forms using one of the methods outlined shared in this article.
My sign-up form is not working/not displaying properly
This error message is displayed when your Brevo account is suspended. To unblock it, contact our support team by creating a ticket from your account.
Copying and pasting the code of a Brevo form into the WordPress form builder (and vice versa) can cause issues with your sign-up form. To ensure proper functionality, you need to re-create your forms using one of the methods outlined shared in this article.
When editing the HTML code of a form created through the plugin's settings, make sure not to modify the "class" attribute. The class attribute should remain as sib-xxx-area
(e.g., sib-email-area
) and should not be altered.
Default form | Modified form (does not work) |
---|---|
If you created your sign-up form directly through the plugin's settings and see a white page displaying {"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":""}
after submitting the form, it means there might be a conflict with another third-party plugin or WordPress theme on your WordPress website.
To resolve this issue, re-create the form in Brevo and embed it using an iframe.
Email are not being sent from WordPress using Brevo SMTP
If the transactional platform is not activated on your Brevo account, you won't be able to send emails from WordPress using Brevo SMTP. To request its activation, contact our support team by creating a ticket from your account.
If you notice that your emails are sent from the plugin using the wrong sender, it might mean that you have deleted the sender from your Brevo account.
To resolve the issue, re-create the sender in Brevo and select it again from the plugin's settings.
If you see the error message "You cannot use SMTP because wp_mail has been declared by another process" when trying to activate transactional emails through the plugin's settings, it means there might be a conflict with another third-party SMTP plugin.
To resolve this issue, deactivate the other SMTP plugins you are using.
If the domain used in your sender's email address is not authenticated, it may result in delivery issues for your emails.
To resolve the issue, authenticate your domain in Brevo.
⏭️ What's next?
🤔 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 expert partner.