Title: EO4WP: EmailOctopus for WordPress
Author: Olaf Lederer
Published: <strong>12 April 2024</strong>
Last modified: 4 September 2026

---

Search plugins

![](https://ps.w.org/fw-integration-for-emailoctopus/assets/banner-772x250.jpg?rev
=3104335)

![](https://ps.w.org/fw-integration-for-emailoctopus/assets/icon-256x256.png?rev
=3104335)

# EO4WP: EmailOctopus for WordPress

 By [Olaf Lederer](https://profiles.wordpress.org/finalwebsites/)

[Download](https://downloads.wordpress.org/plugin/fw-integration-for-emailoctopus.1.1.1.zip)

 * [Details](https://en-gb.wordpress.org/plugins/fw-integration-for-emailoctopus/#description)
 * [Reviews](https://en-gb.wordpress.org/plugins/fw-integration-for-emailoctopus/#reviews)
 *  [Installation](https://en-gb.wordpress.org/plugins/fw-integration-for-emailoctopus/#installation)
 * [Development](https://en-gb.wordpress.org/plugins/fw-integration-for-emailoctopus/#developers)

 [Support](https://wordpress.org/support/plugin/fw-integration-for-emailoctopus/)

## Description

Email marketing is still one of the best ways to drive traffic to your website. 
Use this plugin to add EmailOctopus subscription forms directly with the WordPress
Block Editor or Elementor Pro. A shortcode is available for advanced and custom 
implementations. WooCommerce stores can use the dedicated integration to collect
subscribers during checkout and send order-related information to EmailOctopus.

_To use this plugin, you need to create an API key. You can do this via your EmailOctopus
account. You can get a free account from the [EmailOctopus](https://emailoctopus.com/?ref=eo4wp-plugin).
The free account allows you to add 2,500 active subscribers and has a few limitations
on the account features._

#### These are the features

 * Add EmailOctopus subscription forms using the WordPress Block Editor
 * Integration for Elementor form actions with support for custom list fields
 * WooCommerce integration to collect subscribers and store order-related information
   in EmailOctopus
 * Add a newsletter subscription checkbox to the WooCommerce checkout
 * Shortcode support for advanced and custom implementations
 * Easy to use, custom list fields will be automatically created if they don’t exist
 * Efficient spam protection (using JavaScript and cookies)
 * The visitor stays on your website while submitting the form data
 * Support for multiple mailing lists (EmailOctopus legacy acoounts)
 * Support for multilingual websites (compatible with [Polylang](https://wordpress.org/plugins/polylang/))
 * The form HTML is compatible with the Bootstrap CSS framework
 * Optional: Protect your subscription forms with the plugin [WP Armour – Honeypot Anti Spam](https://wordpress.org/plugins/honeypot/)
 * Optional: Use the CSS style-sheet (Bootstrap compatible) included with the plugin
 * Track successfully submitted forms in Google Analytics and Clicky
 * The plugin includes JS and CSS files only if the form (shortcode or block) is
   present
 * Using nonces for simple form value validation
 * Developer hooks for adding custom form fields, hidden fields and additional subscription
   data

### WooCommerce Checkout Block support

The plugin supports the WooCommerce Checkout Block. The EmailOctopus newsletter 
subscription checkbox can be used with both the classic WooCommerce checkout and
the newer block-based checkout.

The available checkbox positions are automatically adjusted depending on which checkout
type your store uses.

**Important:** If you switch an existing store from the classic checkout to the 
Checkout Block, please review your EmailOctopus integration settings and thoroughly
test the complete checkout process before using it on a live store. The Checkout
Block works differently from the classic checkout, and the position and behavior
of the newsletter checkbox may change.

### About EmailOctopus

This plugin communicates with the email marketing service EmailOctopus via the API.
An active account is required to use this plugin.

For more information:

 * Privacy Statement – [Privacy Statement](https://emailoctopus.com/legal/privacy)–
   EmailOctopus.com
 * Terms of use – [Terms of Use](https://emailoctopus.com/legal/terms) – EmailOctopus.
   com
 * API – [Documentation version 2.0.0](https://emailoctopus.com/api-documentation/v2)–
   EmailOctopus.com

### Block Editor integration

The EmailOctopus form block allows you to add a subscription form directly to a 
page or post using the WordPress Block Editor.

 1. Add the ‘EmailOctopus form’ block to your page or post.
 2. Select the EmailOctopus mailing list.
 3. Configure the form title, description and button label.
 4. Choose whether to show the newsletter checkbox and whether the form should use 
    an inline layout.
 5. Use the submission settings to configure the thank-you message, source, tags and
    reporting options.

The block uses the general plugin settings as defaults. Additional CSS classes and
custom CSS can be added using the standard WordPress block settings.

### WooCommerce integration

If you want to use the EmailOctopus integration for WooCommerce, you need to follow
these steps:

 1. Go to WooCommerce > Settings > Integrations > EmailOctopus
 2. Choose the Mailing list you prefer for the subscription feature on your checkout
    page
 3. Check the other features to include additional order information with each subscription
 4. Enable the option “Subscribe everyone” if you like to use EmailOctopus for non-
    commercial emails (too).

### Elementor integration

If you use Elementor Pro, it’s possible to add the EmailOctopus subscription as 
form action.

 1. Add the Elementor form as usual and choose “EmailOctopus” from “Actions after submit”.
 2. Now point the different mailing list fields to the form fields, by entering the
    field ID.

The “Newsletter” option has a special behavior. Use a checkbox in your form and 
if the checkbox was checked, a tag called “newsletter” will be added to the subscriber
in EmailOctopus.

Check here the [complete documentation](https://www.finalwebsites.com/emailoctopus-for-wordpress/)
for the Block Editor, WooCommerce and Elementor integrations, shortcode options 
and developer hooks.

## Screenshots

[⌊General plugin settings⌉⌊General plugin settings⌉[

General plugin settings

[⌊Shortcode default settings and information⌉⌊Shortcode default settings and information⌉[

Shortcode default settings and information

[⌊EmailOctopus integration settings for WooCommerce⌉⌊EmailOctopus integration settings
for WooCommerce⌉[

EmailOctopus integration settings for WooCommerce

[⌊EmailOctopus form action in Elementor Pro⌉⌊EmailOctopus form action in Elementor
Pro⌉[

EmailOctopus form action in Elementor Pro

[⌊Subscription form example based on the plugin's shortcode⌉⌊Subscription form example
based on the plugin's shortcode⌉[

Subscription form example based on the plugin’s shortcode

[⌊Subscription form inside the Block Editor⌉⌊Subscription form inside the Block 
Editor⌉[

Subscription form inside the Block Editor

## Blocks

This plugin provides 1 block.

 *   EmailOctopus form

## Installation

The quickest method for installing the plugin is:

 1. Automatically install using the built-in WordPress Plugin installer or…
 2. Upload the entire plugin directory to the `/wp-content/plugins/` directory.
 3. Activate the plugin through the ‘Plugins’ menu in WordPress.
 4. Create in EmailOctopus one or more mailing lists and also add an API key.
 5. Enter your EmailOctopus API key, choose the mailing list ID and the other options
    on the plugin settings page.

## FAQ

### How to add a manual goal in Clicky?

If you use a Clicky premium plan it’s possible to track Goals.

 1. In Clicky, visit: Goals > Setup > Create a new goal.
 2. Enter a name for the goal
 3. Check the “Manual Goal” checkbox and click Submit
 4. Copy/paste the ID into the corresponding field on the plugin options page

### How does the “Subscribe everyone” feature work?

Webshop owners can use the WooCommerce integration and EmailOctopus, to send emails
related to an order. For example usage instructions or a request for a review. To
make this work, you need to sync all email addresses and not only the addresses 
from people subscribed to the newsletter. Use the Automation feature in EmailOctopus
for this kind of after-sale campaigns.

### How can I report security bugs?

You can report security bugs through the Patchstack Vulnerability Disclosure Program.
The Patchstack team help validate, triage and handle any security vulnerabilities.
[Report a security vulnerability.](https://patchstack.com/database/wordpress/plugin/fw-integration-for-emailoctopus/vdp)

## Reviews

![](https://secure.gravatar.com/avatar/4e2d2ad473c003743aa0ca9ba5ab0037e43da620980a0bd97c1d6d96c8dd1b7f?
s=60&d=retro&r=g)

### 󠀁[Solid plugin, excellent support](https://wordpress.org/support/topic/solid-plugin-excellent-support-6/)󠁿

 [littlegreenhouse](https://profiles.wordpress.org/littlegreenhouse/) 14 September
2026 1 reply

I added this plugin to my Woocommerce store but had an issue with contacts not being
passed over to Email Octopus. Support was super speedy in helping me troubleshoot
the issue, and even updated the plugin at my request to allow me to set the name
of the tag that's automatically passed between WC and EO. Everything's working perfectly
now, super happy with the plugin and the exceptional support provided.

![](https://secure.gravatar.com/avatar/3fe50d7682ca00f495e8d8f7aa7cda1c9fd2d676cb7ebacd065c8d60c9906caa?
s=60&d=retro&r=g)

### 󠀁[great plugin and excellent support](https://wordpress.org/support/topic/great-plugin-and-excellent-support-325/)󠁿

 [dave70](https://profiles.wordpress.org/dave70/) 10 December 2024 1 reply

Chose this plugin to replace Mailchimp as I had exceeded their subscribers. Olaf
was a great help when I tried to replace the check box sign up I used to get from
Mailchimp so emailOctopus covers everything I needed. Great plugin and excellent
fast support. Big thumbs up to Olaf.

![](https://secure.gravatar.com/avatar/837a05ca262f94aa9edee461a02ac0f145d662354c39892c6e4c8ac446b017bd?
s=60&d=retro&r=g)

### 󠀁[Exactly what I was looking for](https://wordpress.org/support/topic/exactly-what-i-was-looking-for-617/)󠁿

 [3dmoments](https://profiles.wordpress.org/3dmoments/) 15 November 2024 1 reply

Great little plugin! Support was responsive, helpful and open to suggestions on 
features also! Would recommend and suggest anyone who relies of EmailOctopus for
their mailing need to add this plugin. Thank you Olaf.

![](https://secure.gravatar.com/avatar/ad54e06c9d55fc65565a079399feda0b7598387e261a45323ab8c44a6e03979a?
s=60&d=retro&r=g)

### 󠀁[Was waiting for this](https://wordpress.org/support/topic/was-waiting-for-this-2/)󠁿

 [B](https://profiles.wordpress.org/blclda/) 8 August 2024 1 reply

And it delivered, if you want to freely integrate Woocommerce with EmailOctopus 
this is the plugin you're after.

 [ Read all 4 reviews ](https://wordpress.org/support/plugin/fw-integration-for-emailoctopus/reviews/)

## Contributors and Developers

“EO4WP: EmailOctopus for WordPress” is open source software. The following people
have contributed to this plugin.

Contributors

 *   [ Olaf Lederer ](https://profiles.wordpress.org/finalwebsites/)

“EO4WP: EmailOctopus for WordPress” has been translated into 1 locale. Thank you
to [the translators](https://translate.wordpress.org/projects/wp-plugins/fw-integration-for-emailoctopus/contributors)
for their contributions.

[Translate “EO4WP: EmailOctopus for WordPress” into your language.](https://translate.wordpress.org/projects/wp-plugins/fw-integration-for-emailoctopus)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/fw-integration-for-emailoctopus/),
check out the [SVN repository](https://plugins.svn.wordpress.org/fw-integration-for-emailoctopus/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/fw-integration-for-emailoctopus/)
by [RSS](https://plugins.trac.wordpress.org/log/fw-integration-for-emailoctopus/?limit=100&mode=stop_on_copy&format=rss).

## Change Log

#### 1.1.1

 * Improvements
    - Added configurable WooCommerce order statuses for EmailOctopus subscriptions.
      Processing and Completed are enabled by default, with On hold and Pending 
      payment available as additional options.
    - Improved Elementor newsletter opt-in handling. A form field with the ID newsletter
      is now automatically recognized and adds the newsletter tag when selected.
    - Added the fw_eo_newsletter_tag filter to customize the newsletter tag.
    - Improved WooCommerce Checkout Block compatibility and subscription handling.

#### 1.1.0

 * Improvements
    - Added support for the WooCommerce Checkout Block, including newsletter subscription
      checkbox integration.
    - Added a new EmailOctopus subscription form block for the WordPress Block Editor,
      with configurable form and submission options.
    - Improved the Elementor Pro integration with dynamic field mapping for EmailOctopus
      list fields.
    - Added developer hooks for custom form fields and hidden fields.
    - Refactored the subscription form and integration code to improve maintainability
      and reuse across the Block Editor and shortcode.
 * Others
    - The minimum PHP version for this plugin is now 8.0

#### 1.0.11.2

 * Bug fixes
    - Fixed a bug where the $order object was missing inside a method from the WooCommerce
      integration class.

#### 1.0.11.1

 * Bug fixes
    - A minor typo in the WooCommerce integration has been fixed, which was causing
      an error. Please update immediately!

#### 1.0.11

 * Improvements
    - Integration with WP Armour – Honeypot Anti Spam
    - The order status registration process has been further improved
    - On the settings page you can now specify the name for the cookie that keeps
      track of a successful registration.

#### 1.0.10

 * Bug fixes
    - Fixed an issue in the WooCommerce integration where a certain setting would
      sign up all customers for the newsletter.
 * Improvements
    - Replaced the cookie ajax request (in WordPress) with a simple JavaScript cookie
      script for load time improvements.

#### 1.0.8.6

 * Improvements
    - Changed the way how subscriptions via the WooCommerce checkout are handled.
      Now it’s possible add a subscription from the order dashboard as well. The
      order status “completed” and “processing” will trigger a subscription.

#### 1.0.8.5

 * Bug fixes
    - Escaped an HTML attribute for the shortcode.

#### 1.0.8.4

 * Bug fixes
    - Fixed a bug for the WooCommerce integration class where in some situation 
      a fatal error occured during installation.

#### 1.0.8.3

 * Bug fixes
    - Fixed a small bug in the form shortcode

#### 1.0.8.2

 * Security fixes
    - Escaped some output from the form shortcode

#### 1.0.8.1

 * Bug fixes
    - fixed a small issue with the plugin settings API
 * Others
    - Added Patchstack Vulnerability Disclosure Program link

#### 1.0.8

 * Improvements
    - Uppercase the first letter for the subscribers name
    - Updated/aaded new screensots
 * Bug fixes
    - Added a fix to avoid unnecessary API calls
    - Fixed a PHP warning inside the WOO integration
    - Fixed some sanitization issues, update for the WooCommerce integration
 * Others
    - Changed the order of the Changelog

#### 1.0.7

 * Bug fixes
    - Fixed some style for the settings page
 * Improvements
    - Pre-checked checkbox option for the WooCommerce integration

#### 1.0.6

 * Bug fixes
    - Fixed a bug where in some situations the $FWEO_Woo_EmailOctopus_Integration-
      >add_subscriber_callback() method wasn’t called correctly
 * Improvements
    - Better Dutch translations
    - Settings page is re-arranged

#### 1.0.5

 * Improvements
    - Added Dutch translations

#### 1.0.4

 * Improvements
    - Added Font awesome support (replaced Glyphicons)
    - Extended the form shortode to handle tags. Add comma separated tags and submit
      them together with the other subscriber data.

#### 1.0.3

 * Improvements
    - For the callback function “add_subscriber_callback” I changed the hook to “
      woocommerce_payment_complete”, to subscribe only “paying” customers

#### 1.0.2

 * Other
    - Version bump WP 6.6
 * Bug fixes
    - Fixed option name for Woo integration

#### 1.0.1

 * Other
    - The plugin name has been changed in consultation with EmailOctopus
    - Updated graphics, added documentation link
 * Bug fixes
    - Fixed two option names

#### 1.0

 * Initial release

## Meta

 *  Version **1.1.1**
 *  Last updated **1 month ago**
 *  Active installations **200+**
 *  WordPress version ** 6.0 or higher **
 *  Tested up to **7.1.3**
 *  PHP version ** 8.0 or higher **
 *  Languages
 * [Dutch](https://nl.wordpress.org/plugins/fw-integration-for-emailoctopus/) and
   [English (US)](https://wordpress.org/plugins/fw-integration-for-emailoctopus/).
 *  [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/fw-integration-for-emailoctopus)
 * Tags
 * [block-editor](https://en-gb.wordpress.org/plugins/tags/block-editor/)[elementor](https://en-gb.wordpress.org/plugins/tags/elementor/)
   [emailoctopus](https://en-gb.wordpress.org/plugins/tags/emailoctopus/)[newsletter](https://en-gb.wordpress.org/plugins/tags/newsletter/)
   [woocommerce](https://en-gb.wordpress.org/plugins/tags/woocommerce/)
 *  [Advanced View](https://en-gb.wordpress.org/plugins/fw-integration-for-emailoctopus/advanced/)

## Ratings

 5 out of 5 stars.

 *  [  4 5-star reviews     ](https://wordpress.org/support/plugin/fw-integration-for-emailoctopus/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/fw-integration-for-emailoctopus/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/fw-integration-for-emailoctopus/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/fw-integration-for-emailoctopus/reviews/?filter=2)
 *  [  0 1-star reviews     ](https://wordpress.org/support/plugin/fw-integration-for-emailoctopus/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/fw-integration-for-emailoctopus/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/fw-integration-for-emailoctopus/reviews/)

## Contributors

 *   [ Olaf Lederer ](https://profiles.wordpress.org/finalwebsites/)

## Support

Issues resolved in last two months:

     2 out of 2

 [View support forum](https://wordpress.org/support/plugin/fw-integration-for-emailoctopus/)