Docs/Integrations/WordPress Plugin

WordPress Plugin

The official EmailSendX plugin does two jobs: it keeps your WordPress users and WooCommerce customers in sync with your contact lists, and it puts real opt-in forms on your pages using whichever page builder you already use.

Requirements

WordPress 6.0 or newer, PHP 7.4 or newer.
An EmailSendX account and an API key.
The opt-in forms and page-builder elements require a recent plugin version — download the latest below.

Install the plugin

The plugin is distributed directly by EmailSendX rather than through the WordPress.org directory. Installing it takes about a minute.

Download emailsendx-for-wordpress.zip.
In WordPress, go to Plugins → Add New → Upload Plugin and choose the zip.
Click Install Now, then Activate.

Updating

To move to a newer version, download the current zip and upload it the same way — WordPress will ask whether to replace the existing plugin. Your API key, field mapping and settings are stored in the database and are kept.

Connect your workspace

In EmailSendX, go to Settings → API keys and create a key.
In WordPress, go to EmailSendX → Settings and paste the key.
Click Test connection. On success the plugin shows your workspace name.
Pick a default list — this is the list the sync pushes contacts into.

Self-hosting EmailSendX?

Set the API base URL in Settings to your own instance. Your instance must include the /api/v1/forms endpoint, or the form picker will report that no forms were found.

Add a form to your site

The plugin gives you two elements. They behave the same in every builder, and both are also available as shortcodes.

Element	What it does	Opt-in
EmailSendX Form	Embeds a form you built in EmailSendX. The fields, spam protection and confirmation email all come from that form — nothing is rebuilt in WordPress.	Whatever the form uses (double opt-in supported)
EmailSendX Newsletter	A quick email-capture box that adds people straight to a contact list. No form needed.	Single opt-in

Which one should I use?

If you need a confirmed (double) opt-in, use EmailSendX Form and turn double opt-in on for that form in EmailSendX. The Newsletter box adds subscribers immediately, with no confirmation step.

Use it with your page builder

The same two elements are available in every supported builder:

Elementor — widgets in the EmailSendX panel category.
Block Editor (Gutenberg) — native blocks with a live preview.
WPBakery Page Builder — elements in the Add Element panel.
Spectra — the blocks work inside Spectra layouts too.

The Integrations tab inside the plugin shows which builders it has detected on your site and which are live.

Shortcodes

Every builder renders through these two shortcodes, so you can use them anywhere a builder isn't available — a text widget, a theme template, or the classic editor.

bash

[emailsendx_form id="YOUR_FORM_ID"]
[emailsendx_newsletter list="YOUR_LIST_ID"]

You don't need to hunt for the IDs. The plugin's Forms and Newsletter tabs list your forms and lists with a ready-to-paste shortcode for each one.

Style attributes (all optional, and shared by both shortcodes):

Attribute	Values
align	left · center · right
width	narrow · wide · full
size	small · large
spacing	compact · relaxed
field_style	filled · underline
radius	rounded · pill · square
labels	hidden — placeholder-only, still read by screen readers
field_bg, field_color, border_color	any hex, RGB/HSL, or theme palette colour
accent, button_color, text_color	any hex, RGB/HSL, or theme palette colour
button_style	outline
button_align	left · center · right
button_full	yes

bash

[emailsendx_newsletter list="abc123" size="large" radius="pill" button_full="yes"]

Sync users and WooCommerce customers

Separately from forms, the plugin can push people who are already in WordPress into a contact list.

WordPress users — sync all users, or only chosen roles.
WooCommerce customers — detected automatically when WooCommerce is active. Billing name, company, phone, lifetime spend and last order are available as source fields.
Auto-sync — when enabled, new registrations and profile updates are pushed as they happen.
Field Mapping — choose which WordPress field lands in which EmailSendX field, and create new custom fields without leaving WordPress.

Run a sync from the Sync tab. The Log tab shows each batch with a breakdown of created, updated, skipped and failed rows.

Syncing is not consent

Importing existing users adds them to a list — it does not ask them to opt in. Only sync people who agreed to hear from you, and use a form for everyone else.

Troubleshooting

The form picker says “No forms found”

Check the connection on the Settings tab — an invalid key means nothing loads.
Confirm the form exists in EmailSendX under Forms.
If you self-host EmailSendX, make sure your instance includes the /api/v1/forms endpoint.

My styling changes don't show up

Hard-refresh the page (Cmd/Ctrl + Shift + R) — the browser may be holding the old stylesheet.
Make sure you're on the latest plugin version.

Grow your list from WordPress

Install the plugin, connect your API key, and put a real opt-in form on your site in minutes.

Download the plugin View all integrations