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.
   
   💡 Gut zu wissen

   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. Klicke auf Activate (Aktivieren).
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. Gehe im Menü der Seitenleiste auf Brevo > Home (Startseite).
2. Click Sync my users.
   
3. Wähle im Fenster Users Synchronisation (Benutzersynchronisierung):
   1. Die Benutzerrollen, die du synchronisieren möchtest.
   2. Die Brevo-Liste(n), zu der/denen die Kontakte hinzugefügt werden sollen.
   3. The user attributes you want to sync.
      
      💡 Gut zu wissen

      Only the fixed set of default WordPress user attributes available in the dropdown can be synced. Custom attributes are not supported.
      
4. Klicke auf Apply (Anwenden).
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. Speichere und veröffentliche die Seite oder den Beitrag.

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

Schritt 1: Erstelle ein Anmeldeformular

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.

Schritt 2: Aktualisiere den Formularinhalt

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

Ein neues Feld hinzufügen

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. Fülle die Angaben für jedes Feld aus, einschließlich der folgenden:
   • 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.

Ein Feld entfernen

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. Lösche den ausgewählten Text.
4. In the preview, click the 🔁 refresh icon to ensure the form still displays correctly after the change.

Aktualisieren der Anmeldeschaltfläche

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

Schritt 3: Passe das Formular an

Passe das Formular an, indem du die folgenden Optionen aktivierst:

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

Konfiguriere den Anmeldeprozess für Kontakte, die das Formular abschicken:

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

   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.

Schritt 5: Deine Bestätigungsnachricht bearbeiten

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

Bevor du dein Anmeldeformular auf deiner Website veröffentlichst, rufe dessen Shortcode ab:

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. Navigiere zur Fußzeile deiner Website und wähle sie aus.
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. Wenn du fertig bist, klicke auf Save (Speichern).

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. Klicke auf Save (Speichern).

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. 
   
   ❗️ Wichtig

   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. Klicke auf Send email (E-Mail senden) , um deine Test-E-Mail zu erhalten.

Install the Brevo tracker on your WordPress site

To install the Brevo tracker on your WordPress site:

1. Gehe im Menü der Seitenleiste auf Brevo > Home (Startseite).
2. Under Automation, select Yes to activate the Marketing Automation through Brevo option.
3. Klicke auf Activate (Aktivieren).

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

Versenden von Push-Web-Benachrichtigungen

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.

Schritt 1: Aktivieren von Push-Web-Benachrichtigungen

Um Push-Web-Benachrichtigungen an die Besucher:innen deiner Website zu versenden, aktiviere zunächst die Option Push-Web in den Einstellungen des Plug-Ins:

1. Gehe im Menü der Seitenleiste auf Brevo > Home (Startseite).
2. Under Web push, click Activate.
   

Schritt 2: (Optional) Erstelle neue Kontakte in Brevo für jede:n Push-Abonnent:in

Standardmäßig kannst du Push-Benachrichtigungen von deiner Website aus nur über das Brevo Plug-In für WordPress versenden.

Wenn du deine Push-Web-Abonnent:innen auch durch Automatisierungen und Kampagnen in Brevo ansprechen möchtest, kannst du einen Kontakt für sie in Brevo erstellen, wenn sie sich anmelden. Dies gilt sowohl für anonyme als auch für identifizierte Abonnent:innen.

So erstellst du für jede:n Push-Abonnent:in einen neuen Kontakt in Brevo:

1. Gehe in der WordPress-Seitenleiste zu Brevo > Web push (Brevo > Push-Web).
2. From the Settings tab, click Advanced Settings.
   
3. Check the Create Brevo contacts from push notification subscribers option.
   
4. Klicke auf Save (Speichern).

Wenn sich jemand auf deiner Website für Push-Web-Benachrichtigungen anmeldet, erstellt Brevo jetzt einen Kontakt für ihn.

Schritt 3: Verwalte deine Standarddruckeinstellungen

Die Drucksteuerung hilft dir zu verwalten, wie und wann Push-Benachrichtigungen versendet werden. Damit kannst du Folgendes tun:

• Kontrollieren der Versandgeschwindigkeit, um zu vermeiden, dass zu viele Benachrichtigungen auf einmal versendet werden, was deinen Server überlasten könnte.
• Begrenzung der Anzahl der Benachrichtigungen pro Benutzer:innerhalb eines bestimmten Zeitrahmens (stündlich, täglich oder wöchentlich).

Standardmäßig können Benutzer:innen bis zu 10 Benachrichtigungen pro Tag erhalten. Dieses Limit gilt sowohl für Blog-Benachrichtigungen als auch für Push-Kampagnen. Du kannst sie anpassen und eine Standard-Zustellgeschwindigkeit für deine Benachrichtigungen festlegen.

1. Gehe im Menü der Seitenleiste auf Brevo > Web Push (Push-Web).
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. Wähle unter Zustellgeschwindigkeit die Standardzustellgeschwindigkeit für deine Push-Benachrichtigung.
5. Klicke auf Save (Speichern).

Schritt 4: Versende deine Push-Benachrichtigungen

Du kannst dann wählen, ob du zwei verschiedene Arten von Push-Benachrichtigungen versenden möchtest:

• Benachrichtige Abonnent:innen automatisch, wenn du einen neuen Blogbeitrag veröffentlichst
• Erstelle und versende eine gezielte Push-Web-Kampagne zum Zeitpunkt deiner Wahl

Verwende die folgenden Registerkarten, um Anleitungen für jede Option anzuzeigen ⬇️:

Deaktivieren von Push-Web-Benachrichtigungen

Um neue Abonnements zu stoppen und zu verhindern, dass Push-Web-Benachrichtigungen versendet werden, kannst du die Option Push-Web in den Einstellungen des Plug-Ins deaktivieren:

1. Gehe im Menü der Seitenleiste auf Brevo > Home (Startseite).
2. Under Web push, click Turn off web push.
   
3. Klicke auf 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

Wenn du das WordPress Plug-In nicht mehr verwenden möchtest oder Probleme mit ihm auftreten, musst du es möglicherweise deinstallieren.

1. Log into the admin dashboard of your WordPress site.
   
   💡 Gut zu wissen

   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. Gehe im Menü der Seitenleiste auf Plugins > Installed Plugins (Plug-Ins > Installierte Plug-Ins).
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.

Du hast Änderungen am HTML-Code des Formulars vorgenommen

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)	Modifiziertes Formular (funktioniert nicht)

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

⏭️ Nächste Schritte

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

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