The Brevo plugin for WordPress (Newsletter, SMTP, Email Marketing, and Subscribe Forms) makes it easy to connect your WordPress site with Brevo. Use it to create static or pop-up sign-up forms to grow your contact list, send web push notifications, manage transactional email delivery, track page visits, and more — all directly from your WordPress dashboard.
Install the Brevo plugin for WordPress
First, install the Brevo plugin on your WordPress site.
- 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.
Sync your existing WordPress contacts with Brevo
Syncing your existing WordPress contacts (those added before installing the plugin) with Brevo isn’t automatic — you’ll need to do it manually from 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.
Sync your new WordPress contacts with Brevo
After syncing your existing WordPress contacts, you can choose to sync new contacts with Brevo in real time. When a new contact is added in WordPress, they will be automatically synced with Brevo. However, updates, deletions, or blocklisting of contacts will not be synchronized.
There are two methods available to sync new contacts:
-
Using the Brevo tracker
Use the Brevo tracker to identify new contacts when they perform specific actions (e.g., create an account) -
Through a form
Let new contacts subscribe through a static or pop-up sign-up 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.
You can create a static or pop-up sign-up form to add to your WordPress site. Contacts who submit one of these forms will be automatically synced with Brevo. They’ll be added to the list you selected during form setup, and the information they provide will be saved to their contact profile. These contacts will also be automatically subscribed to receive your emails.
To learn how to add a static or pop-up sign-up form to 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
You can create a sign-up form to allow new WordPress contacts to subscribe. When a contact submits the form on your site, they’ll be added to a specific list in Brevo and subscribed to receive your emails. This not only provides proof of their opt-in consent but also enables you to trigger automations based on their form submission.
You can create two types of sign-up forms:
-
Static sign-up form
Standard form that can be embedded on a page or post on your WordPress site -
Pop-up sign-up form
Responsive form that can be triggered after a delay, during exit intent, and on specific pages only
Add a static sign-up form to your WordPress site
A static sign-up form is a standard form that can be embedded on a page or post on your WordPress site. There are two methods available to create and embed a static sign-up form on your WordPress site:
- [Recommended] Create a static form in Brevo and embed it as an iframe on your WordPress site
- Create a static form directly through the Brevo plugin and embed it on your WordPress site using a shortcode
Use the following tabs to view instructions for each method ⬇️:
Create a static sign-up form in Brevo and embed it as an iframe on your WordPress site.
- Create a static sign-up form in Brevo. To learn more, check our dedicated article Create a 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 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
- 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 sidebar or footer of your website
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.
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 sign-up form in the empty field.
- Once you're done, click Save.
Your static sign-up form has been added to your WordPress site and new contacts can start subscribing.
Add a pop-up sign-up form to your WordPress site
A pop-up sign-up form is a responsive form that can be triggered after a delay, during exit intent, and on specific pages only. You can easily install Brevo Popups on your WordPress site and choose when to trigger a pop-up sign-up form to let new contacts subscribe.
➡️ To learn more, check our dedicated article Create a pop-up sign-up form in Brevo.
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.
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:
- In the sidebar menu, go to Brevo > Home.
- Under Web push, click Activate.
Step 2: 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.
- In the sidebar menu, go to Brevo > Web push.
- From the Settings tab, click Pressure settings.
- Under Subscriber protection, change the default limit of notifications a user can receive. You can also create or update the limit by category.
- Under Delivery speed, select the default delivery speed for your push notification.
- Click Save.
You can override the default pressure settings for individual push notifications and campaigns by selecting different settings when configuring the notifications.
Step 3: 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 ⬇️:
Automatically notify subscribers when you publish a new blog post, either for all posts or just specific ones. By default, notifications are sent to all your web push subscribers, but you can choose to target a specific audience instead.
Send a notification every time you publish a new blog post
- In the sidebar menu, go to Brevo > Web push.
- From the Settings tab, click Blog settings.
- Make sure the Automatically send a notification when I publish a post from the WordPress editor option is activated.
- Under Who should we notify by default?, select the list or segment you want to send notifications to.
- Click Save.
You can override the default audience for individual posts by selecting a different one when configuring the notification for that specific post.
Send a notification for individual blog posts
- In WordPress, open or create a blog post.
- In the Brevo Push Notifications section under your post content, make sure that the Send notification on post publish option is activated.
- (Optional) Select a different target audience to override your default blog settings for this post.
- Publish your post.
Create a web push campaign, choose your target audience, and decide when to send it.
Step 1: Create a web push campaign
To create a web push campaign:
- In the sidebar menu, go to Brevo > Web push.
- Click Create campaign.
- Give an internal name to your campaign. This name won't be visible to your subscribers.
- Click Create campaign.
- Create your web push notification:
- (Optional) In the Title field, enter a title for your campaign. This title will appear first in the notification. If you leave this field empty, your website name will be displayed instead.
- In the Text field, enter the content of your notification. This content will appear below the title of the push notification.
- (Optional) Select or drag and drop an image. This image will appear in the push notification.
- (Optional) In the On click URL or deeplink field, enter the URL that should open when a subscriber clicks the notification. If you leave this field empty, your app or website homepage will be used instead.
- (Optional) Activate the Attach data payload option to send an optional JSON data payload along with your push notifications.
- Preview your notification by selecting an operating system (Windows, MacOS, Android) and view how it will render on a specific device.
Step 2: (Optional) Choose your audience
By default, the selected audience includes all your web push subscribers, but you can choose to target a specific audience instead:
- Select one of the following targeting options under Audience:
-
Based on their website activity
Target active or inactive users, depending on how long it’s been since their last visit. This is useful for re-engaging inactive users or promoting new content to frequent visitors. -
New push subscribers
Target users who subscribed to push notifications within the last few days. -
Based on language
Target users whose web browser is set to specific languages. -
Based on timezone
Target users based on the time zone set on their device. -
From a Brevo segment
Target web push subscribers who belong to a specific segment in Brevo. -
From a Brevo list
Target web push subscribers from a specific Brevo contact list.
-
Based on their website activity
-
From the Send to all platforms dropdown, choose whether to send notifications to desktop subscribers, mobile subscribers, or both.
Step 3: Schedule your web push campaign
Choose how you want to schedule your web push campaign:
-
Manually
Send the notification yourself at the time of your choice. -
On a specific date
Schedule the notification to be sent at a chosen date and time. -
Periodically
Set your campaign to repeat at regular intervals. -
When a subscriber performs an event
Trigger a notification when a user performs a specific action on your site. This option will only work if you've activated the Activate Marketing Automation through Brevo option through the plugin's settings and created custom events. -
When a subscriber visits a URL
Send a notification when a user visits a specific page on your website.
-
When a subscriber becomes part of the audience
Automatically send the notification as users meet the criteria defined in your selected audience.
For example, if you chose “New push subscribers”, this option allows you to send a welcome push notification immediately after someone subscribes.
Step 4: (Optional) Manage the pressure settings for your web push campaign
Manage how and when this web push campaign is sent. If you don’t make changes here, your default pressure settings will apply.
- Under Delivery speed, choose the rate at which your notifications will be sent (e.g., Slow).
💡 Good to knowThe Delivery speed option is available only for notifications that are not triggered by a subscriber's action. Otherwise, the notifications will be sent as soon as the subscriber performs the action. - Under Pressure settings, choose how pressure control should apply to this campaign. You can use the default settings, select a pressure category, apply a custom setting, or disable pressure control entirely.
Step 5: Save and send your web push campaign
- To save your campaign, click Save. It will be scheduled according to the delivery settings you selected.
- (Optional) If you chose to send your campaign manually:
- Go to Brevo > Web push.
- From the Campaigns tab, click the three-dot icon next to your campaign.
- Click Send now.
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?
- Install the chat widget on your WordPress or WooCommerce website(s) with the Brevo tracker
- WooCommerce plugin - Installation and set up
- WooCommerce plugin - Create an order confirmation email to send through WooCommerce
🤔 Domande?
In caso di domande, non esitare a contattare il team dell’assistenza creando un ticket dal tuo account. Se ancora non hai un account, puoi contattarci qui.
Se stai cercando aiuto per un progetto che prevede l'utilizzo di Brevo, possiamo metterti in contatto con l'agenzia partner di Brevo giusta per te.