What is MailerWave Connect?
MailerWave Connect is a WordPress plugin that provides a complete bridge between your WordPress website and your MailerWave email marketing account. Once connected, you can build subscription forms, manage email lists, browse and tag subscribers, analyse campaign performance, and automatically add WooCommerce buyers to your list — all from your WordPress dashboard.
Installing the Plugin
Log in to your WordPress admin panel.
Go to Plugins → Add New → Upload Plugin.
Click Choose File and select the mailerwave-connect.zip file.
Click Install Now, then Activate Plugin.
A MailerWave entry will appear in your WordPress sidebar. Click it to begin setup.
Minimum Requirements
- WordPress 5.0 or higher
- PHP 7.4 or higher
- An active MailerWave account with API access enabled
- WooCommerce 5.0+ (optional — only needed for buyer sync)
Getting Started — Settings
After activating, go to MailerWave → Settings. This is where you connect the plugin to your MailerWave account.
Finding Your API Token
Log in to your MailerWave account at app.mailerwave.com.
Click your profile icon (top right) and go to My Profile.
Click the API & Authentication tab.
Copy the API Token shown on that page.
Connecting the Plugin
Paste your API Token into the API Token field.
Select a Default List — used when a shortcode has no explicit list specified.
Optionally enter a Thank-You Redirect URL. Visitors will be sent here after subscribing instead of seeing an inline message.
Click Save Settings. A green “Settings saved.” notice confirms success.
The API Base URL is hidden by default. Click Advanced Settings to expand it.
Only change this if you self-host MailerWave on a custom domain. Default: https://app.mailerwave.com/api/v1
Lists
The Lists tab shows all your MailerWave lists and their key statistics, fetched fresh from the API on each load and cached for one hour.
| Column | What it shows |
|---|---|
| Subscribers | Total number of active subscribers on the list |
| Open Rate | Percentage of subscribers who have opened at least one campaign |
| Click Rate | Percentage of subscribers who have clicked at least one link |
| Sub Rate | Rate at which new subscribers are joining |
| Unsub Rate | Rate at which subscribers are leaving |
| Unconfirmed | Subscribers who signed up but have not confirmed (double opt-in) |
| From | The default sender name and email address for this list |
Click Refresh Lists to force a fresh fetch from the API and update all statistics immediately.
Subscriber Tools
Find by Email
Enter any email address and click Search to look up a subscriber across all your lists. The result card shows all their details and lets you add or remove tags using a comma-separated list.
Tags let you label subscribers for segmentation inside MailerWave. Example: vip-customer, webinar-attendee, woocommerce-buyer
Browse List Subscribers
Select a list to load its subscribers in pages of 25. Filter by open activity or click activity before loading. Each row has two actions:
- Unsub — unsubscribes the contact from that list. They remain on the list in unsubscribed status.
- Delete — permanently removes the subscriber. This cannot be undone.
Add Test Subscriber
Manually add an email address to any list — useful for testing your signup form and welcome sequence before going live.
Signup Forms
Signup forms are embedded in your pages using a shortcode. Each form has its own configuration and can subscribe visitors to any of your lists.
Creating a Form
Go to MailerWave → Signup Forms.
Optionally click a template card to pre-fill the form fields.
Click Create New Form to open the creation panel.
Fill in the Form Name, Title, Description, Success Message, and Button Text.
Choose optional fields: First Name, Last Name, Phone Number.
Select the MailerWave list this form subscribes people to.
Click Create Form.
Fields always display in this order: First Name (if enabled) → Last Name (if enabled) → Email (always) → Phone (if enabled).
Embedding with a Shortcode
Copy the shortcode from the forms table and paste it into any page or post:
Newsletter
form for kdp
Replace 1 with the form ID from the table. Multiple forms can appear on the same page independently.
Form Templates
Click any template card at the top of the Signup Forms tab to instantly pre-fill all form fields with ready-to-use copy. Edit any field before saving.
| Template | Best used for |
|---|---|
| Newsletter Signup | Regular newsletter or content subscription |
| Free Resource / Lead Magnet | Offering a free guide, checklist, or download |
| Webinar Registration | Registering attendees for a live event or webinar |
| Early Access / Waitlist | Building anticipation before a product launch |
| Discount / Coupon Offer | Growing your list with a discount incentive |
| Course / Challenge Signup | Enrolling people into an email course or challenge |
| Contact / Callback Request | Capturing leads who want to be contacted by phone |
| Community Signup | Inviting visitors to join a members community |
Campaign Analytics
The Analytics tab lists all your MailerWave campaigns. Metrics are not loaded automatically — click Load on any row to fetch live data for that campaign.
Campaign Detail Drawer
Click a campaign name to open the detail drawer. This shows:
- Full metric summary — opens, unique opens, clicks, bounces, unsubscribes, delivered rate, last open and last click dates
- Top Locations — countries where the most opens came from
- Top Openers — the subscribers who opened most frequently
- Tracked Links — all tracked URLs with individual click counts
The MailerWave API does not allow creating or editing campaigns via the plugin. To create, schedule, or send a campaign, log in to your MailerWave account directly using the Open Dashboard button.
WooCommerce Integration
If WooCommerce is active, a WooCommerce Integration section appears in Settings. This automatically adds buyers to a MailerWave list when their order is marked as complete.
Setup
Go to MailerWave → Settings and scroll to the WooCommerce section.
Tick Enable to activate the feature.
Select a Buyers List.
Choose your opt-in mode and click Save Settings.
Opt-In Modes
Every buyer synced through WooCommerce is automatically tagged woocommerce-buyer in MailerWave, so you can target them with specific campaigns or automations.
Shortcode Reference
Specific form by ID
Newsletter
form for kdp
Default form (no ID)
Mailerwave: No list configured for this form.
Uses the Default List from Settings. No saved form configuration is applied.
Custom list override
Subscribe to Newsletter
Enter your email to stay updated.
Subscribes directly to the specified list UID, overriding the default. Get list UIDs from the Lists tab.
Troubleshooting
- Ensure your account has the Administrator role (manage_options capability).
- Some security plugins block option saves — try deactivating them temporarily.
- Verify your API token is correct — copy it fresh from your MailerWave account.
- Ensure your server can make outbound HTTPS requests.
- Check
wp-content/debug.logfor entries starting with “Mailerwave API error”.
- Confirm the shortcode ID matches a form in the Signup Forms table.
- Ensure the form has a list selected — forms with no list show an error.
- Clear all caching plugins after installing or updating.
- Confirm WooCommerce Integration is enabled and a Buyers List is selected.
- The sync only fires when an order reaches Completed status — not Pending or Processing.
- If using opt-in mode, confirm the checkbox was visible and ticked at checkout.
- Check
wp-content/debug.logfor “Mailerwave WooCommerce:” entries.
- The phone field loads the intlTelInput library from cdnjs.cloudflare.com.
- If your site uses a Content Security Policy, whitelist cdnjs.cloudflare.com.
Frequently Asked Questions
Can I use multiple forms on the same page?
Yes. Each form instance is fully independent with its own security nonce. You can place as many different forms as you need on a single page.
Can I create campaigns from the plugin?
No. The MailerWave API is read-only for campaigns. You can view statistics and analytics, but to create, edit, or send a campaign you need to log in to MailerWave directly. Use the Open Dashboard button for one-click access.
Will it work if I self-host MailerWave?
Yes. Click Advanced Settings in the Settings tab and update the API Base URL to your own installation, e.g. https://mail.yourdomain.com/api/v1
What happens if someone tries to subscribe with an email already on the list?
The form shows “This email is already subscribed.” No duplicate is created. This applies to both the front-end form and the WooCommerce buyer sync.
Is subscriber data stored in WordPress?
No. All subscriber data lives in your MailerWave account. The plugin communicates with the API in real time and does not store subscriber emails or personal data in the WordPress database.
How do I update the plugin?
Deactivate and delete the existing version, then install the new zip. Your settings and saved forms are stored in the WordPress database and will not be affected.