Skip to content
Wakio
Get started
Transactional Broadcast Automation Pricing Docs Sign in
Docs menu

Guides

Features

API

Integrations

WordPress

Send every email your WordPress site produces through Wakio. Contact forms, WooCommerce order emails, password resets and anything else that goes through WordPress's own mail function keep working as they are, and go out from your verified domain instead of your host's mail server.

You need these before you start:

Install

The plugin is waiting for review on WordPress.org. Until it is listed there, install it from a download:

  1. Download wakio.zip.
  2. In WordPress, go to Plugins, choose Add New, then Upload Plugin.
  3. Choose the file you downloaded, then Install Now, then Activate Plugin.

Set it up

Go to Settings, then Wakio Email. Paste your API key, enter the From address your site should send from, and optionally a From name. Choose Save Changes.

Saving checks your From address with Wakio right away. If its domain is not verified on your account, the page says so and keeps your previous From address, so a typo cannot stop your site's mail.

Then choose Send test email. It goes to the email address on your WordPress account. What you should see: "Wakio sent the test email." and the email in your inbox.

Until both an API key and a From address are saved, the plugin stays out of the way and WordPress sends mail the way it did before.

The From address

A plugin that sets its own From header keeps it, and anything hooked to WordPress's wp_mail_from and wp_mail_from_name filters still applies. Whatever address wins has to be on a verified domain, or Wakio refuses the message.

When a send fails

The plugin never falls back to your host's mail server. Mail that seems to work while skipping your verified domain is worse than mail that visibly did not send. When Wakio cannot send a message, the plugin:

  • tells WordPress the send failed, so the plugin that sent it can react,
  • fires WordPress's wp_mail_failed action, which logging plugins listen for,
  • writes the reason to your site's error log,
  • and shows an administrator a notice saying what went wrong and where to fix it.

WordPress waits at most 10 seconds for Wakio on each email, so while Wakio is unreachable, a checkout that sends two emails can take up to 20 seconds longer.

Cc and Bcc

Each recipient gets their own copy and their own delivery record, so a bounce is recorded against the address that bounced. A Cc recipient does not see the other recipients, and reply-all does not reach them. Each recipient counts separately toward your sending volume.

Update or remove it

A plugin installed from a download does not update itself. To update, download wakio.zip again and upload it the same way. WordPress offers to replace the installed version; choose Replace current with uploaded. Once the plugin is listed on WordPress.org, updates reach your dashboard like any other plugin's, and the copy you installed by hand updates too.

The current version is 0.1.1. Every release stays available under its own version number, so you can always reinstall an earlier one. This one is at wakio.0.1.1.zip, and SHA256SUMS lists the checksum of every release.

Deleting the plugin from Plugins also deletes its settings, including your API key, on every site of a multisite network. The key itself keeps working until you delete it under API keys, so do that too if no other site uses it.