The email queue
Normally WordPress sends an email straight away, while the visitor waits. A slow mail server then slows down your checkout or contact form, and if the server is briefly down the email is lost. With the queue turned on, emails are saved first and sent in the background a moment later, with automatic retries.
Turn it on
- Go to SMTP Settings → Logging & Queue.
- Switch on Send emails via the background queue.
- Adjust the limits if you need to, then click Save Changes.
| Batch size / minute | How many emails are sent each minute (1–200, default 20). Keep it under your provider’s sending limit. |
|---|---|
| Retry delay (seconds) | Wait before the first retry of a failed email (default 300). The delay doubles with each attempt: 5, 10, 20 minutes… |
| Max attempts | How many times an email is tried before it is marked failed (1–10, default 3). |
The queue worker runs every minute on WP-Cron. WP-Cron only runs when someone visits the site, so on quiet sites, or if DISABLE_WP_CRON is set, add a real server cron job that calls wp-cron.php every minute. Diagnostics warns you if the worker is not scheduled.
Manage the queue
Email Queue shows Pending, Processing, Sent and Failed counts and a list of queued emails with their scheduled time, priority and number of attempts.
- Run Now sends the next batch immediately instead of waiting for the next minute.
- Pause Queue stops all sending (including scheduled emails) until you click Resume. New emails keep collecting in the queue.
- Clear Queue empties the whole queue: pending, sent and failed rows, including your scheduled and recurring emails. Cleared emails are not sent. To remove a single email, use the delete action on its row instead.
- Each row can be retried or deleted on its own.
Geplande e-mails
Send an email at a set time, once or on repeat: a monthly reminder to your team, a yearly renewal notice, a weekly report to a client.
- Open Scheduled Emails.
- Onder Schedule an Email enter the recipient(s) (separate several with commas), subject and message. HTML is allowed.
- Choose Send at en Repeat: One time, Daily, Weekly, Monthly or Yearly.
- Klik op Schedule Email.
Times are in your site’s timezone (Settings → General). Upcoming & Recurring lists the next run, how often it repeats and its status. A recurring email moves to its next date after each send and keeps going until you delete it.
Scheduled emails are sent by the queue worker, so they work even when the background queue for normal emails is turned off. They do need WP-Cron to run.
E-mailsjablonen
Email Templates is a library for the email designs you use again and again.
- Klik op New Template, give it a name, a category and a subject, and write the HTML content.
- Use variables, which are replaced with live values in the preview:
{site_name},{site_url},{admin_email},{date},{time},{user_name},{user_email}. - Klik op Voorbeeld to see the rendered email, and Save Template to keep it.
- Duplicate a template to make a variation, or delete ones you no longer need.
To use a template, copy its HTML into a scheduled email or into your own code. Templates can be moved to another site with Import / Export. Developers can add their own variables with the bw_smtp_template_variables filter (see Developer reference).