WordPress plugin - Integrate your WordPress website with Brevo

wordpress-logo.png

Download the WordPress plugin

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.

  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 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

💡 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 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.

  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. 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:

  1. Using the Brevo tracker: Identify new contacts using the Brevo tracker.
  2. Through a form: Allow contacts to subscribe through a form.

Use the following tabs to view instructions for each method:

Option 1: Using the Brevo tracker Option 2: 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

❗️ Important

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:

  1. Using Brevo: Create the form in Brevo and embed it on your website as an iframe [Recommended]
  2. 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:

Option 1: Using Brevo Option 2: Using the WordPress plugin
💡 Good to know
We recommend creating your form directly in Brevo to avoid potential conflicts with third-party plugins or WordPress themes.

After creating a sign-up form in Brevo, you can embed as an iframe on your WordPress website:

  1. Create a sign-up form in Brevo. To learn more, check our dedicated article Create a full page/embedded 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.

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.

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?

 

🤔 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.

💬 Was this article helpful?

69 out of 129 found this helpful