Brevo plugin for WordPress - Connect your WordPress site with Brevo

wordpress-logo.png

Download the WordPress plugin

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.

  1. Log in to your WordPress website's admin dashboard.
    💡 Good to know
    You 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 or the-green-yoga.wordpress.com/wp-admin).
  2. In the sidebar menu, go to Plugins > Add New Plugin.
    wordpress_add-new-plugin_en-us.png
  3. In the search bar, type Brevo.
  4. Next to the Brevo plugin named "Newsletter, SMTP, Email marketing and Subscribe forms by Brevo", click Install Now.
    wordpress_install-plugin_en-us.png
  5. Click Activate.
  6. In the sidebar menu, go to Brevo > Home.
    wordpress_brevo-home_en-us.png
  7. 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.
  8. Click Login.
    wordpress_api-key_en-us.png

You have successfully installed the Brevo plugin for WordPress.

Sync your existing WordPress contacts with Brevo

💡 Good to know
If you want to sync different roles to different lists, repeat this process and set up sync rules for each list individually.

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.

  1. In the sidebar menu, go to Brevo > Home.
  2. Click Sync my users.
    wordpress_sync-my-users_en-us.png
  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 attributes you want to sync.
      wordpress_users-synchronization_en-us.png
  4. 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 ⬇️:

Using the Brevo tracker Through a form

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.

wordpress_brevo-tracker_identified-contacts_en-us.png

❗️ Important

Only their email addresses will be retrieved. These contacts will not be automatically subscribed to receive your emails.

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 form in Brevo Create a static form through the Brevo plugin
💡 Good to know
We recommend creating your form directly in Brevo to avoid potential conflicts with third-party plugins or WordPress themes.

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.
    wordpress_brevo-form-example_en-us.png
  2. At the Share step of the form creation process, copy the iframe code generated by the form builder.
    wordpress_form_share_copy-iframe_en-us.png
  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.
    wordpress_form_html-block_en-us.png
  5. Paste the iframe code into the field.
    wordpress_form_html_paste-iframe_en-us.png
  6. (Optional) Click Preview to see how the form will appear on the page or post.
  7. Save and publish the page or post.

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.

popup_example_en-us.png

➡️ 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:

  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's ,ame and email address.
  4. Enter an email address to send a test email.
  5. 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?.

  1. In the sidebar menu, go to Brevo > Home.
  2. Under Automation, select Yes to activate Marketing Automation through Brevo.
  3. 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:

  1. In the sidebar menu, go to Brevo > Home.
  2. Under Web push, click Activate.
    wordpress_web-push_activate2_en-us.png

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).
💡 Good to know
Users can unsubscribe at any time, so avoid overwhelming them with too many notifications.

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.
    wordpress_push_pressure-settings_en-us.png
  3. Under Subscriber protection, change the default limit of notifications a user can receive. You can also create or update the limit by category.
    wordpress_push_pressure-settings_update_en-us.png
  4. Under Delivery speed, select the default delivery speed for your push notification.
  5. Click Save.
💡 Good to know

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 ⬇️:

Notify for new blog post Send a targeted web push campaign

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

  1. In the sidebar menu, go to Brevo > Web push.
  2. From the Settings tab, click Blog settings.
    wordpress_settings_blog-settings_en-us.png
  3. Make sure the Automatically send a notification when I publish a post from the WordPress editor option is activated.
  4. Under Who should we notify by default?, select the list or segment you want to send notifications to.
    wordpress_web-push_who-should-we-notify_en-us.png
  5. Click Save.
💡 Good to know

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

  1. In WordPress, open or create a blog post.
  2. In the Brevo Push Notifications section under your post content, make sure that the Send notification on post publish option is activated.
  3. (Optional) Select a different target audience to override your default blog settings for this post.
    wordpress_post_notification-settings_en-us.png
  4. Publish your post.

Chat with your customers

conversations_chat-example_EN-US (1).gif

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.

  1. In the sidebar menu, go to Brevo > Statistics.
  2. Select a time period.
  3. Click Apply.
💡 Good to know
If you have also installed the Brevo plugin for WooCommerce, you can view the statistics for each of your email templates. To learn more, check our dedicated article WooCommerce plugin - Installation and setup.

Uninstall the WordPress plugin

❗️ Important
If you uninstall the WordPress plugin, all previously defined settings and created forms will be permanently lost and will need to be recreated. To prevent data loss, we recommend backing up your forms by copying their HTML code and taking screenshots of any settings you've configured before uninstalling 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 in to your WordPress website's admin dashboard.
    💡 Good to know
    You 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).
  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.

Troubleshoot issues with the WordPress plugin

💡 Good to know
Brevo's support team only provides assistance for forms created in Brevo or through the plugin's settings. If you're using a third-party form, contact the third-party support team.

My API key is not working

You see the error message "Please input a valid API v3 key" or "Unauthorized: Key not found"

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

The "Apply" button is not working

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

You are using a native WordPress form or a third-party 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.

You embedded the same form multiple times on the same page

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.

You embedded multiple separate forms on the same 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.

You copy-pasted the code of a Brevo form into the WordPress form builder (or vice versa)

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

You see the error message "We cannot accept this request as your account is blocked due to malicious behavior" when submitting your form

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.

You copy-pasted the code of a Brevo form into the WordPress form builder (or vice versa)

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.

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, 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)
wordpress_form_class-sib_en-us.png wordpress_form_class-modified_en-us.png
The form redirects to a white page after submission

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

Your Brevo SMTP account is not activated

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.

Emails are sent from the wrong sender

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.

You see the error message "You cannot use SMTP because wp_mail has been declared by another process"

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.

Your domain is not authenticated

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?

🤔 Sie haben eine Frage?

Wenden Sie sich bei Fragen an unser Support-Team: Erstellen Sie einfach ein Ticket über Ihr Konto. Wenn Sie noch kein Konto haben, können Sie uns hier kontaktieren.

Wenn Sie Unterstützung bei einem Projekt mit Brevo suchen, können wir Sie mit der richtigen zertifizierten Brevo-Partneragentur verbinden.

💬 War dieser Beitrag hilfreich?

72 von 137 fanden dies hilfreich