Settings

Supported MIME Types
Add just the type (not the subtype). Text, Video, Audio, Image and Multipart are always supported. Put each type on a single line
Banned File Names
Put each file name on a single line.Files matching this list will never be posted to your blog. You can use wildcards such as *.xls, or *.* for all files
Attachment icon set
Attachment icon size (in pixels)
Attachment template
Note that this template are only used if the attachment is not “inline” or if the email type is “plain”

Use First Image as Featured Image
If any images are attached, the first one will be the featured image for the post. As of 1.7.5 the featured image will not be included in the post content.
Include Featured Image in Post
Should the featured image be included in the post.
Automatically insert image gallery
If any images are attached, they will automatically be inserted as a gallery
Gallery Link Type
Allows you to specify the link type used with the gallery. (requires 1.6.18 or above)
Image Location
Location of attachments if using ‘plain’ format. Before or After content.
Generate Thumbnails
Some hosts crash during thumbnail generation. Set this to ‘No’ if you have this issue
Start Image Count At
For use if using “Image Place Holder Tag” below.
Use custom image field for images
When set to ‘Yes’ no images will appear in the post (other attachment types will be processed normally). Instead the url to the attachment will be put into a custom field named ‘image’. Your theme will need logic to display these attachments.
Image Place Holder Tag
For use in ‘plain’ messages. The code for inserting an image. I.e. put “#img1# in your email where you want the first image to show. See also “Start Image Count At”
Image Template
Choose a default template, then customize to your liking in the text box. Note that this template are only used if the “Preferred Text Type” setting is set to “plain.” Sizes for thumbnail, medium, and large images can be chosen in the Media Settings.

{CAPTION} gets replaced with the caption you specified (if any)
{FILELINK} gets replaced with the url to the media
{FILENAME} gets replaced with the name of the attachment from the email
{FILEID} gets replaced with the ID of the media
{HEIGHT} gets replaced with the height of the photo
{ID} gets replaced with the post id
{LARGE} gets replaced with the url to the large-sized image
{LARGEHEIGHT} gets replaced with the height of a large image
{LARGEWIDTH} gets replaced with the width of a large image
{MEDIUM} gets replaced with the url to the medium-sized image
{MEDIUMHEIGHT} gets replaced with the height of a medium image
{MEDIUMWIDTH} gets replaced with the width of a medium image
{PAGELINK} gets replaced with the URL of the file in WordPress
{RELFILENAME} gets replaced with the relative path to the full-size image
{THUMB} gets replaced with the url to the thumbnail image
{THUMBHEIGHT} gets replaced with the height of a thumbnail image
{THUMBNAIL} same as {THUMB}
{THUMBWIDTH} gets replaced with the width of a thumbnail image
{TITLE} same as {FILENAME}
{URL} same as {FILELINK}
{WIDTH} gets replaced with width of the photo
{ICON} insert the icon for the attachment (for non-audio/image/video attachments only – e.g. PDF or DOCX)

Connection

Sockets is preferred, but doesn’t work with some hosts.

Mail Protocol

Port

Standard Ports:
POP3 – 110
IMAP – 143
IMAP-SSL- 993
POP3-SSL – 995

Mail Server

Mail Userid

Mail Password

Postie Time Correction

Should be the same as your normal offset, but this lets you adjust it in cases where that doesn’t work.

Check for mail every

Maximum number of emails to process

Delete email after posting

Only set to no for testing purposes

Enable Error Logging

Log error messages to the web server error log.

Enable Debug Logging

Log debug messages to the web server error log.

Preferred Text Type

Emails typically contain both plain and html formatted versions of your email. Use html if you want the “rich text” version of the email used to create the post.

Text FallbackUse plain if html is missing and vice versa.

Default categorySpecifies the category to apply to the post by default.

Match short categoryTry to match categories using ‘starts with logic’ otherwise only do exact matches. Note that custom taxonomies will not be found if this setting is ‘No’

Use colon to match categoryOne option for specifying a category is to place it on the subject line followed by a colon (:). E.g. “category1: The real subject”. However, some mailing lists include colons for other reasons so you can turn off the colon based category detection if needed.

Use dash to match categoryOne option for specifying a category is to place it on the subject line surrounded by the dash (-). E.g. “-category1- The real subject”. However, some mailing lists include dashes for other reasons so you can turn off the dash based category detection if needed.

Use square bracket to match categoryOne option for specifying a category is to place it on the subject line surrounded by square brackets ([]). E.g. “[category1] The real subject”. However, some mailing lists include square brackets for other reasons so you can turn off the square bracket based category detection if needed.

Default tag(s)The optional list of tags to be applied to the post.Separated each tag with commas. E.g. “tag1, tag2, long tag”

Default Post StatusThe status to assign to the post.

Default Post FormatThe format to assign to the post.

Default Post TypeThe type to assign to the post.

Default TitleIf no subject is found then use this text. It is unusual for a subject to be missing. Some SMS to email systems don’t add a subject which is why this setting exists.

Treat Replies AsWhen a reply is detected you can choose how you want Postie to treat the reply.

Strip Original Content from Replies

Forward Rejected Mail

Allow Subject In MailEnclose the subject between ‘#’ on the very first line. E.g. #this is my subject#

Allow HTML In Mail SubjectIf set to “No” Postie will convert all HTML markup into html entities (“

” → “<p>”) . This allows you to display html tags. Otherwise no conversion will happen and the html will be applied when the post is displayed in WordPress.

Allow HTML In Mail BodyIf set to “No” Postie will convert all HTML markup into html entities (“

” → “<p>”) . This allows you to display html tags. Otherwise no conversion will happen and the html will be applied when the post is displayed in WordPress.

Text for Message StartRemove all text from the beginning of the message up to the point where this is found. Optional.

Text for Message EndRemove all text from the point this is found to the end of the message. Optional.

Filter newlinesPlain text email have automatic newlines about every 70 characters. If set to “Yes” Postie will remove these newlines, but will retain any double newlines as a paragraph break. This setting has no effect on HTML emails.

Replace newline characters with html line breaks (
)
Filter newlines must be turned on for this option to take effect.

Return rejected mail to senderIf the email is rejected for any reason should the sender be notified?

Send post confirmation email toWho should receive an email for each successfully processed email?

Automatically convert urls to linksShould bare URLs be converted to real links?

Encoding for pages and feedsThe character set for your blog. UTF-8 is recommended, but you may need something else if your WordPress is very old.

Drop The Signature From MailUse the signature patterns (below) to try and find the email signature and remove it.

Signature PatternsPut each pattern on a separate line. Patterns are regular expressions and are put inside ‘/^{pattern}\s?$/miu’. For HTML content the inner text of each element is evaluated against the pattern. E.g for

some test


signature

Postie will evaluate ‘some text’, ‘– ‘ and ‘signature’ against the pattern(s) and the first time it find a match it will assume that is the signature and remove it and anything below it from the post.

Roles That Can Post

This allows you to grant access to other users to post via email if they have the proper access level. Administrators can always post.

Authorized Addresses

Put each email address on a single line. Posts from emails in this list will be treated as if they came from the admin. If you would prefer to have users post under their own name – create a WordPress user with the correct access level.

Default Poster

This will be the poster if you allow posting from emails that are not a registered blog user.

Force User Login

Changing this to yes will cause Postie to try and login as the ‘from’ user if they exist. This should be set to ‘Yes’ if you use custom taxonomies in the subject line.

Allow Anyone To Post Via Email

Changing this to yes is not recommended – anything that gets sent in will automatically be posted.

Video template 1
Note that this template are only used if the video is not “inline” or the “Preferred Text Type” setting is set to “plain”
Video 1 file extensions
Use video template 1 for files with these extensions (separated by commas)
Video template 2
Note that this template are only used if the video is not “inline” or the “Preferred Text Type” setting is set to “plain”
Video 2 file extensions
Use video template 2 for files with these extensions (separated by commas)
Audio template
Note that this template are only used if the audio is not “inline” or the “Preferred Text Type” setting is set to “plain”
Audio file extensions
Use the audio template for files with these extensions (separated by commas)