Post By Email

Gets the email message from the user's mailbox to add as a WordPress post.

Author:Kat Hagan (profile at
WordPress version required:3.6
WordPress version tested:3.7.1
Plugin version:1.0.4b
Added to WordPress repository:28-08-2009
Last updated:25-09-2013
Warning! This plugin has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.
Rating, %:84
Rated by:16
Plugin URI:
Total downloads:19 771
Active installs:300+
plugin download
Click to start download

Warning: This plugin is currently in beta! Use at your own risk and please report any bugs, either on the WordPress Support forums or via the Github issues page.

Any new messages sent to the configured email address will be posted to the blog. This plugin replaces the functionality that used to live in WordPress core.

Once an email has been successfully posted to the blog, it can either be marked as read (IMAP servers only) or deleted from the mailbox.

Updates on the project can be found on the Make WordPress Core blog.


  • Supports IMAP or POP3 servers, with or without SSL
  • Optional PIN-based authentication guards against email spoofing
  • Uses WordPress's built-in roles to manage which users can post
  • Set categories, tags and custom taxonomies by including shortcodes in your email
  • Email attachments will automatically be added to the post's gallery
  • Emails from unauthorized users can be either set as pending or discarded

Post Authors and Security

The "From" address is matched to WordPress users in the database to determine the post's author. If the author doesn't have an account or isn't allowed to publish posts, the post status will be set to "pending".

By default, any users in the Author, Editor or Administrator roles are able to publish posts. Use the Users menu item in the admin dashboard to view and manage which users have this capability. For more information on the WordPress permissions system, see Codex: Roles and Capabilities.


By default, emailed posts will be placed in the default category configured in the settings.

You can also set the categories, tags and custom taxonomy terms on your posts by including shortcodes in your email. These should be space-separated. Use slugs for tags (and non-hierarchical taxonomies) and either slugs or IDs for categories (/ hierarchical taxonomies). Terms that do not yet exist will be created. Examples:

Categories: Use either slugs or IDs.

[category posted-by-email another-category]
[category 14]

Tags: Use slugs.

[tag cool-stuff]

Custom Taxonomies: Use slugs for non-hierarchical taxonomies, and IDs for hierarchical.

[custom-taxonomy-name thing1 thing2]
[another-custom-taxonomy 2 3 5]


Any files attached to an email will be uploaded to the Media Library and added to the post as a gallery. You can specify gallery options, or its location within the post, by including a gallery shortcode in your email. If no gallery shortcode exists, it will be added to the end of the post.