WordPress Newsletter Widget

Last updated 06/02/2022

Add the Bread & Butter Newsletter widget to any page on your site. The Newsletter dialog will pop up after a specified number of seconds, prompting to user to authenticate with the provider of their choice to sign up for your newsletter. Once authenticated, users are added as a Subscriber user in WordPress.

Bread & Butter remembers who has signed up, and won’t prompt them again.

This guide explains how to add the Newsletter widget to any page on your site, and how to configure the content you want it to display, including background image.

Step 1

Go to Bread & Butter IO on the left side menu in WordPress to begin the Setup process.

Step 1

Step 2

Under Dashboard, ensure that Conversions is Enabled. If Conversions is not enabled, please follow the Conversions Install Guide.

Step 2

Step 3

Click on the Newsletter Widget tab.


Step 4

Specify the pages that you want the Newsletter widget to appear on. You can choose one or many pages.

Step 4

Step 5

Enter the event code. This is the API event code that you want to trigger when a user signs up for the newsletter. Don't have an API event or Integration and Rule set up yet? Check out Integration Setup.

Step 5

Step 6

Set the remaining Newsletter settings:

  • The Header is the text that will appear at the top of the window.
  • The Main Message is the main body of text in the window. This should explain what your newsletter is, and why the user would want to sign up.
  • The Success Message is the message that users see after they have signed up successfully.
  • The Delay Popup is the amount of time after the page loads that the Newsletter widget pops up.
  • The Custom Image URL will appear on the left side of the Newsletter widget. If you don't include an image URL, a default image will be used.
Step 6

Step 7

Click Save to save and apply your changes.

The Newsletter widget will now appear on the page(s) you specified in Step 4.