Core functions

Supports several mail accounts (max. 2 in the free version).
Supports standard Internet mail protocolos: POP3, IMAP, SMTP; as well as Microsoft’s EWS protocol for Exchange.
Main window shows all folders selected for synchronization at a glance.
Messages are loaded one “page” at a time as needed, scroll to bottom to load more.
Supports GMail – like way of working with email, when old messages are never deleted from the server.
Mail check time is independent of the number of messages (my Gmail account has over 100,000).
Supports viewing plain text and rich text messages, including embedded images.
Supports rich text formatting when composing messages including the signature (bold/italic/underline, font size, font color, embedded images, typeface).
Fast attachment loading, attachment cache.
Flexible mail check scheduling.
Sound, LED, vibration notifications for new mail and errors. Per account notification options.
Silent mode for nights and weekends.
Preloads new message text and attachments (up to specified limits) when checking mail. Full message text is loaded on demand, when a message is viewed.
Can load full message text and attachments if put into background (pressing the Home key).
Support for SSL and TLS encryption.
A home screen widget with unread / total message counts that can be set to an account or a specific folder, and a message list widget. Both have several built-in themes.
Separate settings for WiFi vs. mobile network (including a separate outgoing mail server setting for WiFi, if needed).
IMAP: IDLE (push email), instant incoming message notifications (if supported by the server).
IMAP and EWS: messages can be moved between folders.
Smart Folder for quickly browsing messages that might need attention.
Per-folder color indicators.
Message navigation without leaving the message view (two variations on swiping).
Swipe actions in message list.
Swipe navigation between messages.
Android Wear smart watch support.
Calendar sync for Exchange accounts.
Push mail for Exchange accounts (since 1.7, Pro version only).
Contact sync for Exchange accounts (since 1.9, both Free and Pro versions).
Message grouping (conversations).

What are the options for deleting messages?

There are three methods to delete messages.

The choices are: “Move to Deleted folder first” / “Delete from the server immediately” / “Hide in the app, keep on the server”. The initial default setting is “Move to Deleted”.

When using IMAP, you can synchronize the [ Deleted ] folder with the server if you like. With EWS, this is always the case.

Deleting messages from Gmail requires that they first be moved into the Deleted folder, which in turn has to be set up to synchronize with “[Gmail]/Trash”. When setting up a Gmail account, AquaMail sets this up automatically.

For POP3, the Deleted folder is local, so don’t forget to empty it from time to time (this will delete messages from the server).

The default delete method is specified under “Options and folders” / “Account options” separately for each account (long press on the account in the main screen to open). The setting is called “Deleting messages”.

Changing the default changes the icon you see when viewing a message or when selecting several messages in a message list.

You can apply a non-default delete method in a message list by using the menu (or the “three dots” button which Google calls “overflow”).

So for example, you can keep the default method as “Move to deleted”, and if you see spam messages you’d like to delete immediately, select them, then use the Menu / Overflow button and choose “Delete now”.

How can I delete messages in AquaMail without deleting them from the server?

Each account has a setting for the default way to delete messages. The initial setting is “move to deleted first, delete from server when purging the deleted folder”.

To change the default: long press on the account in the main screen and choose “Options and Folders”, then “Account options”.

Tap “Deleting messages” and choose “Hide in the app, keep on the server”.

This will change the default action icon for deleting messages from this account to “hide”.

Hidden messages can be restored by using the menu in the message list view. They will be also automatically deleted from the app at a later point to reclaim storage space.

Note that it’s not really necessary to delete messages from the app — old messages are automatically deleted over time without affecting the server, keeping storage usage under control. The default is to keep 250 most recent messages per folder (and can be changed in each account’s Folders and Options as “messages to keep”, renamed as “messages to cache” in 1.4).

How do I access server side folders?

This is only possible with IMAP or EWS (POP3 does not support access to individual folders).

There are two ways to access folders from AquaMail: on an “as needed” basis, or by setting certain folders to sync (keeping them up to date, just like the Inbox).

“As needed”: Start from the title bar or the side bar of any other folder’s message list, there is an item labeled “Other folders…”. This item is also present when moving messages between folders, and also, on tablet sized devices, in the account list.

When accessing folders this way, recently accessed ones will be shown in the folder view (dropdown or side bar) and the account list. They are removed from the recent list automatically, over time, or you can long press on a “recent” folder to clear it. To change how long the app keeps recent folders and how many, please see app settings -> account list.

To enable or disable the “Other folders…” entry in the account list, please long press on an account, choose “Options and Folders”, then “Account options”, scroll to the end and enable “Show Other folders…”.

“Setting to sync”: You can set any folder or folders to sync (every time the app checks mail in the account), which will also make it always visible in the account list (“main window”) for easy access.

Long press on the account in the main window, choose “Options and folders”, then “Folders”. Or choose “Manage folders…” next to where “Other folders…” was. Tap a folder, choose how it should be synced (most likely “Sync, plain folder”).

To clear a folder’s “set to sync” setting, go back to this screen and choose “Do not sync” for a folder you don’t need to be kept up to date all the time.

There is a “+” icon on this screen (“Manage folders…”) to create a server folder.

If you delete any folders that are set to sync in the app (using web mail, or another mail app), please bring up Account Options / Folders in Aqua Mail to sync its folder list with the server.

How to change the order of accounts in the main window?

Account are initially sorted by name.

To move an account within the list, long press on it, then choose “Change order” from the popup menu.

Enabling message zooming and auto-fit

Senders' images and color chips (colored letters) in message lists

Please see app settings under “message list” and enable or disable “contact images” and “color chips” right below.

When viewing or composing email, the font is too small

While viewing or writing email, adjust the font size using the volume keys. The setting is remembered, so if done accidentally, you might need to readjust the font.

Or you can use Menu -> View -> Smaller / Larger font.

In two-panel mode (on tablets), this is how you can adjust font size for the account list (left panel) while the volume buttons go to the right panel (message list).

Also on tablets, the Menu that refers to the left panel in two panel mode is going to be the famous “three dots icon” in the app’s “action bar” (top right corner of the screen).

What is the Smart Folder?

The Smart Folder shows messages which, over a selectable time period:

1) were sent (this is the date/time in the header);
2) were read, including read in other apps (for IMAP).
3) or are unread, no matter what their date/time is.

You can also include starred messages in this list, please see app settings under Smart Folder or the navigation drawer (side panel) in the smart folder’s message list view.

In other words, this is the list of messages that might require attention, or that you might need to come back to. This folder is enabled by default, but can be disabled in the app’s settings.

Per-folder color labels are also enabled by default, but can be disabled in settings.

To assign a folder a different color, or to set whether it’s included in the the Smart Folder, please do this:

1) long-press the account in the main window
2) choose “Options and folders”, then “Folders”
3) scroll to whichever folder you wish to change
4) long-press the folder or tap the settings icon to the right of the folder’s name

Why is there star between the unread count and the total count for some folders?

A folder is marked with a star (e.g. “3 * 100”) when it contains new, just received, messages. Viewing the folder’s message list resets the star. This lets one keep track of which folders need attention.

How do I enable Push mail?

Push must be enabled (configured) in 3 places: (1) for the entire app, (2) for the specific account, and (3) for the specific folder(s).

Given the app’s default settings, usually only step (2) is necessary to enable push mail for an account.

(1) For the entire app:

This is enabled by default, but please see app settings -> mail, receiving.

(2) For the account:

This is off by default.

Long press on the account in the main window (account list) and choose “Options and Folders”, then “Account options” and you’ll see it.

(3) For the folder(s):

This is enabled by default for the main Inbox folder, but is disabled for other folders.

Long press on the account in the main window (account list) and choose “Options and Folders”, then “Folders”.

Find the Inbox (or whatever other folder), tap the folder name and set it “to sync”, then tap the gears (settings) icon on the right or long press on the folder name.

You’ll see a popup window with options specific to this folder, including push mail.

In addition, there is an account level option to restrict push mail to WiFi (e.g. use Push mail over WiFi when at home or at work, but avoid wasting mobile traffic and battery power while en route). To access, please long press on the account -> options and folders -> account options, it’s right next to the “enable push mail” checkbox.

Notification icon in IMAP Push mode

This is required by Android for apps that need to stay in the background for extended periods of time, to avoid being “killed” by the system. You definitely would not want that for push email.

AquaMail tries to do things “by the book” and therefore follows this.

There is way to remove the notification in the app’s settings (the setting is under “Look and Feel”). When the notification disabled, the app will use its own tricks to stay in memory and avoid getting killed.

Can I make the app start in the Smart Inbox or some other folder?

Yes it’s possible starting with 1.2.

Please see the app’s settings, then look under “Look and Feel”, the setting is called “Start the app in…”.

Helloooo, where is your privacy policy?

Version 1.5.1+: new look, how to change

Version 1.5.1 defaults to Google’s new look, called Material Design (when running on Android 4.0+). This includes a “floating action button” (pencil, “compose new message”).

First, it’s possible to change the “accent” color from blue, you can pick any color in app settings under Look and Feel.

Second, the old themes (light and two dark ones) are still there, again, please see app settings under Look and Feel.

Finally, the Floating Action Button can be switched off (except when using the new theme on Android 5.0), please see settings under…. Look and Feel.

Gmail's new authentication, OAUTH2

OAUTH2 is Google’s preferred method for apps to log into your account, where a mail app doesn’t need to know, store, or transmit the password. They’ve been gradually enforcing by turning off regular login / password authentication.

When adding a new account, Aqua lets you pick “Gmail or Google Apps” as an account type.

Then you can choose a Gmail account already present in the device’s system settings (under accounts), Aqua will ask for your permission to access the account’s email messages, and that’s all. No need to re-enter your password into AquaMail.

Or you can choose “Other…” and Aqua will take you to Google’s web site for authentication (right in the app, in a window). You will need to enter your password there, but Aqua won’t see it or use it. Just like with a system account, you will need to grant permission for the app to access your email messages.

Gmail accounts already existing in AquaMail prior to 1.5.1 can be switched to OAUTH2 without losing any account data or settings.

First, make sure that the app has checked mail in this account at least once, so it can detect that it’s a Gmail (or Google Apps) account.

Second, long press on the account, choose Account setup, and you should see a green panel with a prompt to upgrade. Once an account has been switched from login / password to OAUTH2, there is no going back, so might make sense to create backup first (Menu -> Backup & Restore in the account list).

Gmail, and 'OAUTH2 network errors'

This specific to Gmail’s preferred authentication (login) method, called OAUTH2, and happens only with account(s) present in the phone’s system settings.

This is a known issue inside Google Play Services, on some types of networks.

Really needs to be fixed by Google and the mobile operator, but…

Version 1.6.2 added a workaround which can be applied in-place (without re-creating the account):

Long press on the account -> account setup -> enable “Force web based login” and press Next.

The app will open a popup window for you log into the account on Google’s web site, this only needs to be done once.

OAUTH2 for Hotmail /

OAUTH2 is a more secure method for apps to log into your account, where a mail app doesn’t need to know, store, or transmit the password.

As of version 1.6.2, OAUTH2 authentication is also supported for Hotmail. You’ll see it when adding a new account into AquaMail.

To convert an existing account, long press on it (the account) -> account setup and you should see a green panel offering the upgrade.

Notifications about all unread vs. just new messages

As of version 1.4, there is a setting under “Message notifications” for whether Aqua will notify about all unread messages (including old ones), or only about “truly new” unread messages.

The default is “all unread”, consistent with versions prior to 1.4 (and some people to prefer this logic for notifications, myself included).

When using the “new unread” option, swiping a notification from the status bar will make the app not notify you about same messages messages. You can think of it as “Dismiss, ignore”. This is how it works in the Android Gmail app.

What UI options are there?

There are UI settings for:
– the overall color scheme (light / dark with light messages / dark with dark messages)
– message list format (0/1/2 lines of preview, subject or sender first, date grouping headers)
– message display format (multitouch zoom or not)
– showing the last sync time for each account in the main window
The font can be adjusted using the volume keys when in message list, message display, or message compose windows.

How can I see the full list of message recipients?

When viewing a message, tapping on the header switches between brief and full header modes.
The full mode shows all message recipients, while the brief mode is optimized to be just two lines tall.

Is there a spell checker?

On Android 4, the app can use the spell checker built into the system. You can enable it in the device’s system settings, under Languages and Input. Once this is done, spell checking will be automatically enabled in the compose area.

If the setting is not there – the feature must have been removed by your Android device manufacturer from their flavor of Android system software. I can’t find it on my Samsung phones (but it’s there, as expected, on a Sony and an HTC).

On all Android versions, the app can work with Spell Checker by FlipDog Solutions, LLC – which is free on Google Play. Once this app is installed, the compose window in mine will have an item in its menu to call the spell checker as an external app.

Swiping between messages

With the default settings, you can swipe between messages.

Optionally, if you turn off app settings -> swiping -> “between messages”, then it’s also possible by swiping on the message headers.

Please see app settings -> message view to change whether “previous” / “next” mean “older” or “newer”.

Finally, when swiping through a message thread (group), the app skips the older messages. If you’d like for swiping to iterate through all messages in a thread, new or old, please see app settings -> conversations -> turn off “smart message navigation”

Printing messages

Use Menu -> Copy/Send/Share/Print -> Send/Share/Print message text when you have a message open. Then choose your printing app from the app selection window (i.e. where to “send” message text).

A variety of printing apps is supported, but I especially recommend Cloud Print by Paolo Fernandes, which can print formatted messages, including images.

Version 1.4 has support for Google Cloud Print, which is built into Android since version 4.4. The relevant menu item in the same place, under Copy/Send/Share/Print.

Setting a signature

This is a per-account (not app-level) setting, so that each account can have a different signature (corporate / personal / etc.)

1) long-press an account in the main window
2) choose “Options and folders”, then “Composing and Sending”.
3) The signature setting is on the next screen.

Setting a BCC to self

This is a per-account (not app-level) setting.

1) long-press an account in the main window
2) choose “Options and folders”, then “Composing and Sending”.
3) The “BCC to self” setting is on the next screen.

What are those pink / blue / green triangles next to folder names?

Each folder that’s set to sync with the server (and therefore shows in the account list and other places) is automatically assigned a color.

You can disable folder colors in the app’s settings. It’s also possible to change the automatically picked color by doing this:

1) long-press the account in the main window
2) choose “Options and folders” then “Folders”
3) scroll to whichever folder you wish to change
4) long-press the folder or tap the settings icon to the right of the folder’s name
5) you’ll see a dialog with per-folder settings, the color is one of those

How do I add an account?

For the first account, i.e. when there are no accounts yet, the “add” button is smack in the middle of the (empty) account list area.

For the second (and more) account, please use Menu / Add account.

Now, what is the Menu? The Menu is either a “real” hardware button (on more “traditional” phones), or a sensor button below the screen (often seen on the more modern ones), or the on-screen “three dots” icon (Google calls it “the overflow affordance”), right in the app’s interface, on the very right of the icon bar (which starts off with “refresh”, “compose”, etc.).

How can I rename an account?

In the main window, long-press an account, then choose “Rename account”.

Can I exclude a particular account from scheduled mail checks, without having to delete it?

Long press on the account name in the main window – choose “Options and folders” – then “Account options” – clear “Scheduled sync” and “Enable IMAP Push”.

How can I delete an account?

Long press on the account name in the main window – choose “Delete the account”

Changing an account's password in the app

Long press on the account (in the account list), choose “Account setup”, enter the new password, press Next.

When composing a new message, not all accounts are available in the account list

Most likely, some accounts don’t have an outgoing mail server configured.
Long press on the account name in the main window – choose “Account setup”, then “Manual”, “Next”, and make sure there is an outgoing server configured.

Requesting a 'read receipt'

The app supports requesting a “read receipt” when composing messages. This is in the menu.

Note that not all apps support read receipts on the receiving side. My app does not (yet), and neither do Gmail (Android or web), iPhone Mail (as reported by a user), built-in Android Email (the stock one from Google, manufacturer-enhanced versions may differ).

Moving messages into spam folder

The app supports an easy way of moving spam into the server’s spam folder (for IMAP accounts only, as POP3 does not provide server folder access).

1 – Long press on the account, choose “Options and Folders” then “Folders”
2 – Scroll down to the server’s Spam folder (for Gmail, that’s “[Gmail]/Spam”).
3 – Tap the spam folder, choose “Sync as spam” or “Spam, do not sync”.

Now the menus in message list mode (when one or more messages are selected) and message viewing mode will have an item to move message(s) to spam.

Using the app with mail hosted at GoDaddy

Please use these settings in Manual account setup mode:

Incoming server: type IMAP, server name, security SSL (strict), port 993 (will be filled in automatically)
Outgoing server:, SSL, port 465

Note that it’s “smtpout” not “smtp”.

GoDaddy’s IMAP server claims to support IDLE (push email), but in practice, it’s unreliable. This is a server side issue, and affects other apps. According to a GoDaddy support engineer, IMAP IDLE it not supported, and he has no explanation why their servers list that capability.!topic/k-9-mail/srdtV5MzRWQ

More tips from a user:

A. Server config.
Instead of generic
1. Login in godaddy account
2. Click “launch” in email section
3. Clik on the link “Server Settings” and use the servers from there.

B. Issue with SMTP relays.
If you’ve got the error that the send quota was exceeded, using the same steps, re-assign the number of relays for your account:
1. Login in godaddy account
2. Click “launch” in email section
3. For the account you are using, click on the corresponding drop down, click on edit and set again the number of relays. Be aware, the setting might take up 24 h.

Using hosted Gmail (Google Apps) accounts

Please use Gmail / Google Apps account type, this will use Google’s preferred authentication (OAUTH) and fill in the right server settings.

What security / privacy features are there?

To prevent someone from reading your mail, the app has access control using a PIN code or fingerprint (newer Android version). Please see app settings (under Security).

There also is a privacy setting for notifications which suppresses the display of sender/subject/preview.

What does the Time reference point setting do?

This is the time reference point for scheduled background mail checks.
Every 15 minutes counted from 0:0 would be 0:15, 0:30, 0:45 and so on.
Every 15 minutes counted fromт 0:10 would be 0:10, 0:25, 0:40, and so on.

What does the 'System settings' setting do?

AquaMail can either observe, or ignore settings under “Account and sync” in your device’s system settings.
This lets you disable automatic network sync for e.g. weather or news and keep AquaMail checking mail according to its set schedule.

How can I disable scheduled mail checking in the background?

Please see the app’s settings, under “Receiving mail”: “Scheduled mail checking” and/or “Enable IMAP Push”.

How can I change account type between IMAP and POP3?

An account’s type (POP3 / IMAP) cannot be changed once the account’s been set up.

Is there a way to save sent messages on the server?

Yes, the app can upload sent messages to an IMAP folder. There is also a setting for “BCC to self”.

For most IMAP servers, this should be configured automatically. If it was, you should see a color “label” on the left side of the account’s “[ Sent ]” folder in the account list.

To configure manually:
1) long-press the account in the main window
2) choose “Options and folders” then “Folders”, tap the server’s sent folder, choose “Sync with [ Sent ]”.

Note that some servers (e.g. Gmail) automatically save all outgoing email without the application needing to upload them. The app will be pulling down, rather than uploading, your sent messages.

Why are messages loaded using POP3 not marked as read on the server?

POP3 has no support for marking messages as read or unread. Some mail services mark messages as read once they’ve been downloaded by a mail application, some do not.

Why are messages loaded using IMAP get marked as read all by theselves?

Can happen if you mix IMAP (in Aqua Mail) with POP3 (in another mail app, say Outlook for Windows).

POP3 has no support for marking messages as read or unread. Some mail services mark messages as read once they’ve been downloaded by a mail application, some do not.

IMAP does have support for syncing the read/unread per-message state.

So what can happens is:

– a new message arrives, is initially unread;
– when it’s retrieved with Outlook for Windows (let’s say) over POP3, the mail service will mark the message as read;
– since POP3 has no read/unread sync, the message will remain unread in Outlook;
– but since it’ll be marked read on the mail server, and IMAP (in Aqua Mail) does have read/unread sync, the message will show as read in Aqua Mail.

Solution: don’t mix POP3 and IMAP. The best way to access an account from multiple email apps is to use IMAP in all of them.

Unread message counter on the app's icon (badge)

Android provides no way to do this that’s 1) standard 2) accessible to third party apps.

AquaMail can do this on recent Sony, Samsung and LG devices (+ ASUS and Huawei added recently), in the standard launcher (home screen), by using unofficial, undocumented functions intended for apps built into the phone.

Please see app settings under “message notifications”.

There are two more options:

– Using AquaMail’s “message counter” widget.

The widget has several visual themes and can be configured to “point to” a specific account or a folder. You can find it in the same place as all other widgets, varies by Android version and phone make / model, so please try long pressing on an empty spot on the home screen.

– Switching to a third party launcher that has this capability.

Apex Launcher Pro (you will need to enable “External notifiers” in its settings, under Advanced)

Nova Launcher Prime (you’ll need to install Tesla Unread, no other configuration is necessary)

Smart Launcher (you’ll need to install Smart Launcher Notifications).

Unread counter on the icon (badge) is wrong on Samsung devices

The feature to show the unread count is undocumented and unsupported by Samsung — intended only for their own apps, built into the system.

When it’s used by third party apps like mine, the results can sometimes be unpredictable.

Most of the time, it works fine (including 3 Samsung devices on my desk), but sometimes it doesn’t — and since it’s unofficial and unsupported, I can’t ask Samsung for any assistance.

You can reset the counter using a special app I wrote just for this, it’s available on the downloads page here (not in Google Play).

If this still doesn’t work, I recommend turning the unread counter off, in AquaMail settings, under “Message notifications”.

With this unread counter off, there are still Aqua’s built-in message counter widgets, and also third party launchers that officially support an unread count on the icon (Apex Pro, Nova Prime, Smart Launcher 2).

How can I specify my own mail check interval?

In the app’s settings, look under “Receiving mail”.
Scroll down a bit and specify your own “Custom check interval”.

Can I send any attachment type or just pictures?

The application can send any type of file attachment. In order to attach something other than an Gallery image, please install a file manager.

Shrinking (resizing) large images (photos) when sending

Option 1: built into AquaMail since

– App settings -> Composing and Sending -> Shrink large images when sending

– Bring up the above screen at least once to enable the feature, and optionally, select a default “target size” which will be applied immediately when you attach an image.

The “large” target size is probably what you’ll want: large enough for computer monitors, and yet producing reasonable file sizes.

– On the compose screen, you will see original and estimated shrunk file sizes, like this: “Foo.jpg 5.2 MB ( ~ 1.4 MB )”, where “5.2 MB” (megabytes) is the original file size, and “~ 1.4 MB” is the estimated shrunken file size.

– You can use Menu -> Shrink images on the compose screen to adjust the already attached images.

* Works on JPEG format images.
* Availability varies with phone hardware, most modern phones / tablets should be OK.

Option 2: using a third party app.

Please install QuickPic (free in Google Play).

Once you do, the menu in the compose screen will have a new item to “Attach cropped image” that will bring up QuickPic to crop / resize images before they’re attached to your message in AquaMail.

How does the application load attachments?

Attachments are downloaded into the specified folder (by default, /download) as needed. This folder is under your full control, you can remove unneeded files at any time.
When using POP3, attachments are also saved into a hidden folder on the phone’s “large built-in storage” during scheduled mail checking, this is called caching. A cached attachment will be moved into the “/download” folder without having to download it from the server.
When using IMAP, attachments are loaded as needed. There is a setting under account options to preload and cache attachments up to a specified limit (set per message).

Cannot save attachments on the external sdcard

In Android 4.4, Google made a deliberate change that prevents third party applications from saving data on the “real” (external) memory card, on devices that also have a large built-in storage (like a memory card, but built in).

Android Police has a good write-up.

The change affects all third party applications, and there is no way around it – it’s a system policy, and, to reiterate, a deliberate change.

Caching attachments on the external sdcard (microSd)

Since 1.6.2, it’s possible to “cache” attachments on the real microSd card if the phone runs Android 5.0 or higher.

Caching is where attachment files are stored after they’ve been fetched to the phone, just tapping an attachment for viewing does not move the attachment from the cache (this only happens when you use three dots menu to “save” an attachment).

So by and large, the majority of your attachment files, in the normal course of using the app, are “cached”.

To set this “cache” to use the real microSd card, please see app settings -> look and feel -> “Folder for caching attachments” -> set to “On the memory card”.

If this item is not present, then most likely the phone does not have a microSd card or it cannot be accessed in a standard way.

Why does Aqua resize images inserted into formatted text?

Yes, embedded images are resized.

First, they’re not meant to be used for photos and such. That’s what attachments are for.

Second, I ran into an issue in the Android text editor (which my rich text editor is built upon): it doesn’t render any embedded images wider than the screen.

How can I limit the amount of used traffic when there are large incoming messages?

There are settings for how much new message text is loaded when the application performs scheduled background mail checking.
You can also limit automatic message loading that’s triggered when viewing an previously incompletely loaded message.
There are separate settings for WiFi vs. cellular data connection.

Messages out of order, or wrong message dates

If the app is not downloading most recent messages from an IMAP account:

This can happen if you uploaded a lot of messages using a desktop mail app, maybe when migrating to a new mail provider, or moved a lot of messages to a new folder.

Can also be caused by a server bug, since IMAP guarantees ordering by date for incoming mail.

Version 1.4+ has a new per-account setting that lets you specify how many messages to sync by a date range, rather than by the number of messages. This works even in the above scenarios.

To use this setting: long press on the account -> options and folders -> account options, and change the “Messages to sync” setting (formerly called “Messages per page”) from a number based value (like “25” or “50”) to a date range based value (like “7 days” or “14 days”).

For migrated accounts, if you’ve uploaded your messages, some IMAP mail servers will then report the date/time when you did this as the date/time stamp for all messages.

If you’re seeing this, please delete the account in Aqua, add it back, and before it syncs any messages, open the account’s options and folders -> IMAP options, and change “which message date/time to download” to “Date/time sent (from message header)”.

App not fetching all recent messages from Hotmail

Symptoms: a Hotmail account shows a few very recent messages, and then there is a large “gap” to 2013 or something.

A known issue that seems to come up pretty often in @hotmail / @outlook accounts.

I guess it’s their ongoing “migration to new servers”.

Please try this:

– Long press on the account -> options and folders -> account options.

– Change the “messages to sync” setting from a number based value (“25
messages” etc.) to a date range based value (“last 7 days”, etc.)

( You can refer to the previous FAQ entry just above for screenshots. The part after the screenshot there does not apply. )

– Back out and refresh the account

The number of messages in a folder is suddenly zero, but there are messages in it

For a POP3 account, you might have checked email in a program that’s set to remove downloaded messages from the server. AquaMail displays the number of messages on the server, so seeing a zero is normal in this case.

How can there be 10 / 1 messages - 10 unread, 1 total?

For POP3, AquaMail takes the total message count from the server, and has its own, local unread count.
So, let’s say during a mail check there are 10 new messages, which will be marked as unread since they’re just being downloaded for the first time.
Now by the time of the next mail check, all messages but one are deleted from the server using some other program.
This would give you 10 unread messages in AquaMail, and 1 total, taken from the server.

What is the largest message I can send?

Most mail servers limit message size to about 30-40 megabytes. Considering that attachments are base64 encoded, this means about 25-30 megabytes per message.

What does the 'WiFi in sleep mode' setting do?

A phone or a tablet is can be set to disable WiFi when the screen is off to save battery.
When this setting is on, AquaMail will enable WiFi and try to connect to a WiFi network when waking up for scheduled background mail checks.

How can I make a backup of my mail accounts?

Please use the Menu on the app’s main window and choose “Backup and Restore”. You can back up your account and folder settings, and optionally include the app’s settings.

The backup file is encrypted with a password (of your choosing) which will be required to restore.

The app lets you easily upload / download the backup file to / from cloud based storage (Google Drive, OneDrive,, Dropbox) and then restore from there. Or you can copy the file yourself, it’s under “backup/AquaMail” on the phone’s “large built-in storage”.

Please note that actual messages are not archived or restored. The app will re-sync them from the mail server(s).

Entering and picking emails (contacts)

AquaMail integrates with the device’s Contacts/People application (which is in turn synced with your device’s account(s) and other accounts you may have configured, such as Google+).

The app will display a drop-down list of matching contacts as you enter them in any of the recipient entry fields (after two characters), matching on names and emails.

You can also press the contact picking button to the left of each recipient entry field to bring up the app’s own contact picker. The built-in contact picker filters contacts by email, has search, and a group tab where you can pick a whole group or individual group members.

It also has a “recents” tab which shows email addresses from recent messages, regardless of their existence in the device’s Contacts/People app, and an Exchange tab (for Exchange accounts) also with search.

It’s also possible to use the system contact picker using the respective entry in the Menu when composing a message (or making it permanent in the app’s settings under Contacts)

Since version 1.6.0, the app offers Exchange contacts (from the selected account) in auto-completion (enabled by default, can be disabled by long pressing on the account on the app’s main screen -> Exchange options).

Since version 1.6.1, the app can also offer actual recent emails (not saved in Contacts) in auto-completion (disabled by default, can be enable in app settings -> Contacts).

Saving mail recipients (contacts)

You can save any already entered names/emails when composing a message by long pressing on the contact picking button to the left of the respective entry field. You’ll be prompted for which one to save if there are several.

Also, AquaMail can automatically save all your outgoing mail recipients in the device’s Contact list. This is disabled by default, you can enable it in the app’s settings under Contacts.

When enabled, AquaMail will add all outgoing mail recipients to a separate group, “AquaMail”, which will be created in your device’s primary Google account.

Accessing recent email recipients

The built-in contact picker (a button to the left of each recipient entry field) has a tab with “recents” — email addresses used in a certain number of recent messages, both incoming and outgoing, even if those addresses don’t exist in the Contacts / People app.

This list is built from actual recent messages. When all messages with a particular address have been removed from the device, the address will disappear from the contact picker’s recent list as well.

You can also enable “recents” right in the auto-complete when entering addresses, which will make it unnecessary to bring up the contact picker window. That’s in app settings -> Contacts.

Sending messages to a group

I’m not aware of a way to ask Android to pick a group of contacts. There are three workarounds:

Tap a contact picking button to the left of the respective address entry field. In the app’s built-in contact picker that comes up, swipe to the Groups tab, and either select one and all its contacts, or expand and select some of them.

2 – Create a dummy contact with a list of email addresses, separated by commas. The app will expand the list and add each email as a separate item. As far as I know, K-9 works the same way.

3 – Open the device’s Contacts/People app, open a group, use the menu / buttons / etc. to “Send email”, then choose Aqua Mail from the offered list of apps. Works on stock Android, some manufacturers remove this function.

Where does AquaMail store its messages?

Messages are stored in a database in the device’s internal memory.

Attachments are cached in “large built-in memory” (the one that’s 16GB, 32GB etc.) or since 1.6.2 this can be on real microSd the memory card (Android 5.0+).

Is it possible to access stored messages after a device reset?

As long as the internal memory is cleared, no.

How long are old messages stored on the device? How can I delete them?

Usually, old messages are deleted automatically, each folder keeping the most recent 250 messages.
You can specify a different setting in a particular account’s “Options and folders”, either for the entire account, or for a specific folder (use the settings icon on the right side of a folder’s name).
You can also compact the message store deleting old messages by using the menu in the main window.

Can I move AquaMail to the memory card?

No, for a variety of reasons: performance, reliability, security, Android documentation.
Some non-official firmwares will let you move AquaMail to the memory card even through it’s disallowed by the application. This may or may not work, and is not a supported configuration, but you are welcome to try, if so inclined.

How do I exit AquaMail?

By pressing Back or Home. There is no concept of Exiting an application in Android.

There are settings (under “Look and feel”) to exit the app when Back is pressed in the message list… a setting for the popular “long press Back to exit” is there too.

New account setup - manual or automatic?

There are two ways to set up a new account: manual and automatic.
Pressing Next after entering your email and password will cause AquaMail to either apply presets for a certain number of popular email services, or to try to guess incoming and outgoing server names based on your email address. This works most of the time, but there may be exceptions requiring manual setup.
Pressing Manual in the account setup window lets you enter all server settings by hand, and the application will use them exactly as entered.

Using the app with

The app has an automatic account setup preset for

If you experience login errors — please log into your web mail, go to “Preferences” then “General”, then select “Login” using “Standard (AJAX)” instead of “Basic (HTML)”.

Yahoo and 'login error OCF12', error code 999, error code 1213

Error message: NO Please verify your account by going to (yahoo login page) (#MBR1213).

Please open the link in this message and follow Yahoo’s instructions (to make them happy again).

Error message: “[UNAVAILABLE] LOGIN failure. Server error–please try again after some time. Error code OCF12” or similar with “error code 999”.

This is an issue with Yahoo’s servers, maybe a specific one (or several) since they are load balanced (there are tons and tons of servers referred to by the same name).

The error message is returned by the server, it just isn’t letting the app log into the account.

It only affects some accounts from time to time, and seems to correct itself.

Searching the web brings up the same issue with K-9 Mail and other mail apps (Outlook on the Mac, to pick a really different example):!topic/k-9-mail/5rYV6LbBWeY!topic/k-9-mail/NCd8USGwvqM

Yahoo does not seem interested in (or capable of) fixing this, or providing any info on what the error code means.

Second issue that can occur with Yahoo is an “authentication error 999”. Again, different mail apps on different platforms are affected.

A workaround I discovered is going to Yahoo Mail website, logging out, restarting the web browser, then opening Yahoo Mail web site and logging back in. This fixed the issue when both my app and stock Android Email on my Galaxy Nexus were affected.

Another thing to try is to long press on the account in Aqua Mail, choose “Account setup”, then press Manual, and change “” to just “” (removing the “android.” part). Stock Android email uses “”, while K-9 uses “”; I’m not sure about the difference, but this should get you a different server on Yahoo’s side.

Finally, status bar error notifications in AquaMail can be turned off, then it’ll be just like K-9 (which silently ignores these errors, not checking mail when they happen of course).

Push mail in Hotmail / accounts (quite new news)

(posted April 8 2016): Microsoft is in the process of upgrading the technology behind Hotmail / Outlook accounts, and there is now IMAP IDLE (push mail) support.

There is a way to request that your existing Hotmail account be converted “as soon as possible” if you log into the account in web mail (at, there is a button labeled “I want it” (or similar, mine’s already converted so the button doesn’t show).

To actually use push for the account in AquaMail it’s same steps as for other email services:

Long press on the account (on the app’s main screen) -> options and folders -> account options and enable “IMAP Push” there.

If the “IMAP Push” checkbox is disabled and subtitled “This server does not support IMAP push”, it just means that your account had not been converted yet to the newer Hotmail technology.

Folders in Hotmail / accounts (pretty old news)

Automatic setup uses IMAP (with folders) since versions / 1.4.1-53, released July 30, 2014.

Earlier versions used POP3 (no folders).

To switch from POP3 to IMAP, remove the account from Aqua and add back without changing any settings, that is, enter your name / email / password, and press Next.

And please change one setting too (I didn’t include it in app itself, sorry):

Hotmail’s outgoing server automatically saves sent messages, and this causes duplicates (one saved by Hotmail, the other saved and uploaded by Aqua).

Long press on the just added Hotmail account -> options and folders -> composing and sending -> turn off “Save sent”.

Now sent messages will be *downloaded from* Hotmail *to* AquaMail — not *uploaded* into Hotmail *from* AquaMail, including messages sent by Aqua.

What if I run into a crash or an issue?

Crashes are automatically recorded in a crash log, called log-AquaMail-crash.txt and located at the root of your device’s memory card. Please send it as an attachment to / at sign / gmail / dot-com.

Providing information when something doesn’t work right:
In the application’s settings, enable “Debug logging” (very bottom). Set “Log output location” to “Root of memory card”. You will need to enable “Include raw data” most of the time, if the issue is related to specific message(s) or account(s).
Once logging is enabled, please repeat whatever was causing the issue.
After having done this, you can disable logging and send the log file, stored at the root of your device’s memory card and called log-AquaMail.txt, to / at sign / gmail / dot com.
The log does not contain your email account passwords.

How can I specify an account as default for sending?

Starting with version, there is an app setting (under Composing and sending) to specify the default account/alias for new messages.

Other than that, AquaMail remembers the account most recently used for composing mail until the next time. You can always change the account for the current message using a popup/dropdown list.

Replying and forwarding offers to use the same account where the replied / forwarded message was received (can be changed with the drop-down, too).

Is there support for multitouch zoom when viewing messages?

Sure, please see the app’s settings, enable “Browzer-like zoom” under “Message display”.

How do I download an attachment without opening it?

Long press on an attachment.

Linked pictures (images) in incoming messages

With the default settings, the app will not show linked pictures (images) right away, because linked images are often used by spammers to track you.

There is a panel/button just between the message header and its text content. Tap it once to show images, tap again to save the sender’s address as “known” (safe) for future use. The panel/button has help prompts.

You can turn the whole feature off by pressing the settings icon on the right side of the panel, and disabling “Show only from known”.

There is a second level check for this, too – linked images are turned off for mobile data (and enabled for WiFi). You can change this on the same settings screen as in previous point.

Blank entries for Skype contacts

If you have Skype for Android installed, you may see ghosted entries when autocompleting addresses in the compose window, which are same as your Skype contacts and yet have no emails when you pick them.

This is an issue with how Skype syncs its contacts to Android devices:

It’s been reported for about two years now, and not fixed yet, so it may never be fixed.

A confirmed workaround is to go into Skype settings on Android and to turn off its contact sync setting.

Can't confirm deleting a message from the notification bar

On Android 4.1 and higher, a single message notification has a button to delete the message. When you tap it, the notification changes, asking for a confirmation “using the button below”. Sometimes that “button below” is not visible.

The app requests the confirmation button, but the final decision is out of my control (in the system).

When / if this happens, you can make the “two finger zoom out gesture” on the collapsed confirmation notification, horizontally, to expand it and reveal the confirm / cancel buttons.

May not be easy to do, but that’s how the folks at Google designed it…

The app's notifications are not showing

On Android 4.1 and above, please check the device’s system settings -> apps management -> AquaMail -> details -> make sure that “notifications” is checked (enabled).

This is a system level setting that my app doesn’t control. When off, it suppresses notifications for the respective app.

Apparently this setting has a mind of its own, and can magically become enabled (by the system). It also disables in-app toast messages, this was reported to Google just recently, in July of 2012 (</irony>).

Gmail and 'too many simultaneous connections'

This is a server-side limitation (counting all devices / mail apps, excluding the native GMail Android app).

Each folder in push mode requires its own connection. In addition, every time the device loses connectivity (which does happen with mobile devices), it takes the server a few minutes to notice and cross out the now dead connections.

To resolve – consider reducing the number of folders in push mode (e.g. Drafts, Deleted, etc.)

Since IMAP push is fairly expensive battery-wise, this will improve battery life as well.

If you’re only using 1-3 folders already, then the error might be caused by the phone’s unstable network connectivity.

Some manufacturers have an “energy saving” mode that disconnects the network when the screen switches off, that sort of thing. This will disconnect all current push connections as well.

'SSL certificate change', Gmail and others

You’ve enabled an AquaMail feature where it remembers the SSL certificate used by every mail server it connects to, and warns you if that certificate changes.

A change might indicate an MITM (Man in the middle) attack on your password, or may be a legitimate change made on the server.

This is in app settings under Network.

When you see this message, it’s you job as a user to:

1 – tap the message

2 – review if the change seems safe to you

3 – let the application know what you’ve decided, whether it can treat the new certificates as safe

To do this, tap the message, then review, tap a certificate, then click “OK”. The “Issued by” information is probably the most useful part here, that should help you decide.

On the other hand, if you get this message in a cafe / airport / carwash, and the new certificate looks suspicious — then it would be in your interest to *not* accept the change.

Gmail is notable in that Google changes its SSL certificates quite often (lately, once a week it seems), much more so than any other mail service.

In closing – if the application could make such choices itself, it would. If you find that the feature to track SSL cert changes is inconvenient, you can always turn it back off (which is the default).

Status bar message: Service version update required

The message is about Google Play Services, which is used by AquaMail to securely connect to Gmail. It’s referenced by Aqua even if you don’t use it for any Gmail accounts (since it’s the same app).

Two ways to update:

1 – Open this link on the phone, using Google Play app (when prompted) and use the “Update” button there.

2 – Open the Google Play app and check for updates under My apps (My apps is in the sidebar which you can pull it from the left edge of the screen).

Android 5+ and high battery use, 'mobile radio active'

A widespread issue in Android itself affecting a multitude of apps, at random, even Google’s own.

Screenshots on the forum:

Discussions elsewhere on the Internet:

Bug report in the Android bug tracker, right now “starred” by over 4000 affected users, with screenshots of this issue in Gmail, Google Play Services, WhatsUp, Hangouts, Chrome, etc.:

Google promised that the bug would be fixed in Android 6 (but it does not seem to be, at least not fully, there are screenshots from Nexus 6P in that bug discussion).

Android 5 and per-account notification icon color

Android 5.0 and above forces status bar icons to pure white, no matter what color is used from an application.

Therefore, we removed the now useless setting.

What you can do is long press on an account and “assign color”: it will be used in notifications as an “accent” color, but only when they’re pulled down (expanded).


But maybe it’s wrong because “app X” still has color notification icons?

A few technical bits then.

Android 5.0+ removes color if the app is marked as “designed for 5.0” or newer, and AquaMail is marked as “designed for 6.0” (required to ask for permissions on first use, not at install time).

If “app X” or “app Y” shows color notification icons, it means it’s not marked as “designed for 5.0+” (this is different from being able to run on 5.0… even old apps created for Android 1.0 still do).

This is official Android 5.0 documentation, please scroll to “Notifications”:

Update or remove assets that involve color. The system ignores all non-alpha channels in action icons and in the main notification icon. You should assume that these icons will be alpha-only. The system draws notification icons in white and action icons in dark gray.

Android 5 and icons along the top (not bottom)

Since 1.8, all of AquaMail’s themes are based on “material design”, Google’s relatively new design trend, used by many many other apps.

With Android 5 and newer now accounting for more than 60% of all Android devices out there, we had a lot of requests for this, so felt it was time to do it.

As a side effect of this change, Android 5 and newer no longer supports the icon bar along the bottom.

This was reported to Google by myself and others while Android 5 was still in development, and was closed as “working as intended” (i.e. won’t be fixed, and it wasn’t in 6.0 or 7.0 or 7.1).

Please note that this does not apply to the app’s “message view” mode or tablets (two panel layout) where we are able to use our own “icon bar” implementation and place it along the bottom.

So the only “views” affected are the app’s main screen (the list of accounts) and the “message list” view.

Even though icons along the bottom on those two screens won’t be coming back … the app has capabilities that make it easier to use it with one hand and not have to reach to the top:

– Floating Action Button for compose
– Swipe down for “check mail”, works on the main screen and in message lists both
– Swipe down (on the left) for “select all messages” in message lists
– Swipe gestures don’t have to be started near the top of the screen
– Floating context bar with icons for “actions on selected messages”, positioned near the bottom.

With that in mind, please see app settings -> look and feel, and enable “floating action button” and “floating context bar”. And then app settings -> message list -> please enable “pull to select” and “pull to refresh”.

Turning off Calendar and/or Contact sync for Exchange accounts

It’s a per-account setting.

Long press on your Exchange account -> options and folders -> Exchange options, and you’ll see it.

Archiving messages

Supported for IMAP / EWS accounts, not POP3, since AquaMail 1.5.7.

+ Long press on the account -> options and folders -> folders

+ Choose or create your archive folder:

For Gmail: use Gmail -> All Mail

For Fastmail, iCloud, maybe others: use pre-created Archive

For the rest: if there is no archive type folder, tap the “+” icon to create one

+ Tap the chosen folder, choose “Sync as Archive” or “Archive, don’t sync”

+ Assign a swipe gesture for message lists, if wanted: app settings -> swiping -> scroll down to “message list”

+ Assign notification icon, if wanted: app settings -> message notifications -> action icons. I recommend “Delete or archive, depending on the account” if some of your accounts will have “archive” and some won’t.

Message text not showing (Android 4.4 and above)

Assuming messages do show back in the folder’s message list (with 1-2 lines of message text), and so does message header info (subject, to…) when you open a message.

Please tap reply to check if message text shows there (below, in the quoted area).

If it does, then it means that the app does fetch message text, and tries to show it, but the message text display area remains blank, independently of the app.

A fairly common cause of this — specific to Android 4.4 and above — is various “password management” apps like 1Password, LastPass, etc. and other app that integrate into Android’s accessibility.

Please check the device’s system settings -> accessibility settings, and look under “Services”. If you have anything listed there (sometimes anti-viruses show there too, for some reason) — please try disabling and rebooting the phone.

The developer of one such app (a password manager) thinks it’s a bug in Android. I concur.

Turning off the hiding of quoted text

Since 1.5.9, message view by default hides quoted text (old text in replies).

To turn this off and always show full message text: app settings -> message view -> hide quoted text.

Message header scrolls, why?

This is what a lot of users wanted, to give more room to message text, especially on phones which have limited “real estate”.

Implemented in 1.5.9.

Miss the old 'attachments in the side panel'?

I had a good number of complaints that swiping to the side panel was “difficult and confusing”.

I listened to those complaints (feedback) and moved attachments to below message text (or above, settings -> message view) in 1.5.9.

In addition, the new way lets the message header scroll with message text, leaving more room (to see the text).

There is a “fast scroll thumb control” on the right side which shows as soon as you’ve scrolled down past the message header. Then you can scroll to attachments quickly, by dragging this thumb control to the bottom.

If you preferred the old layout, please enable app settings -> message view -> “attachments above text” and “hide attachments”.

Not exactly as before, but this is a compact view with just one tap to show (and hide back) the list of attachments, no need to scroll down.

Not able to take screenshots of AquaMail (some error message about DRM)

This can happen if you’ve enabled app settings -> security -> PIN code / fingerprint.

When you do this, AquaMail marks its window as “secure” — to prevent its contents from showing in Android’s “recents apps” list (which anyone can see, even when the app itself is “locked”).

Regrettably, this also makes Android block the screenshot taking capability (even though it’s not the intention).

'Select All' function selects only one screen full of emails, instead of all

“All” can mean different things to different people.

That is not a bug, it’s intentional, so that people do not delete all messages, thinking that they are deleting only those on the screen.

You can change the app’s logic here in Settings -> Message list -> ‘Select “All” means’.

Message filtering (rules)

Sorry no such feature in the app.

I believe that message filtering is best done right on the mail server (service):

– Most mail services have supported it for a decade if not longer (try “settings” after logging into your account on the mail provider’s web site).

– One place to set things up, vs. in each mail app

– Consistent between all mail apps (mobile / desktop / etc.)

– No additional setup if you get a new phone

Gmail specific: if you’re going to “move” messages, please also turn on “archive (skip inbox)” for each rule (you’ll see this while creating it) — without it, Gmail will *copy* not *move* the filtered messages.

Messages to sync and messages to cache settings

Copied from the forum

So, does that mean that the number set as “to cache” is the number of messages kept on the device and available to be shown by AM?


Re: and available to be shown by AM


When you open a folder’s message list, the app shows the (usually) smaller number, “messages to sync” — those messages which are *known* to still exist on the server and in a known state (read/unread etc.)

The “messages to cache” comes into play if you scroll a folder’s message list down to “see more” — then the app can more quickly re-sync the next …. messages just by checking with the server for their existence and state (as opposed to full download).

Another way to see all those cached messages is to do menu -> view -> offline list (in message list view). This is done automatically if the device is in airplane mode.

Kerio not supported as an Exchange server

My Exchange code is based on the official Microsoft Exchange documentation, and works fine with Exchange 2007 SP1 and above, including Office 365.

Kerio supposedly can work like an Exchange server. In theory.

But in practice, I found that even the most basic Exchange commands fail.

This is for Kerio to fix, not me. If they say that their product can work “like Exchange” then they should actually make it work (maybe?).

Have notifications remain until specific account is accessed

Menu -> Settings -> Message notifications > scroll down almost to the last item -> enable “Manage per-account”.

Green or red 'lock' icon when viewing a message, DKIM and SPF

First, this is new in 1.6.1 and can be turned off in app settings -> message view -> “Show security info”.

What it is:

DKIM and SPF are technologies related to email transmission security.

A green lock tells you that the message you’re viewing was “signed” by the mail server on the sending side and the signature “passed verification” by the mail server on the receiving side (the one hosting your mail account).

In practical terms, it means that the message’s content has not changed while en route.

A red lock tells you that either DKIM or SPF “failed to validate”, so either the message’s content, as received, is not what was sent, or the sending party used a computer which is not “authorized” for sending messages from his/her email’s domain (e.g. a message ostensibly from “” but coming from a computer that has nothing to do with Microsoft).

Even if you get a red lock, it does not necessarily mean that someone’s intentionally tampering those messages with malicious intent: the indicator is purely technical, it just means that your (receiving) mail server decided that the digital signature didn’t validate, could be due to a software bug on the sending or the receiving mail server(s).

Crashes when opening messages (Android 5.0 and newer)

Most likely an issue with WebView (the part of Android used for displaying message content, it gets updates from Play).

Please try uninstalling updates to this app (Play link below), rebooting the phone and checking if the issue goes away. If it does, you may want to install WebView updates again.

App not checking mail (with specifics for Android 6+ Doze Mode, Samsung, Xiaomi MIUI, Huawei, ASUS)

In general, if the app is not checking mail (the default is once every 15 minutes), then the most common culprits are:

– For Android 6.0 and newer, its so called Doze mode

– Memory optimizer apps and battery optimizer apps (e.g. Clean Master)

– Sometimes those are third party apps, sometimes built into the phone’s system software (Xiaomi, Huawei, possibly others)

Android 6 and newer and its “Doze Mode”

Doze Mode is where Android will not let apps run in the background as often as they need to while the phone is stationary.

This kicks in after a few hours on Android 6 and sooner on Android 7.

The app will prompt you to “whitelist” (exclude) it from this “Doze Mode” within a day after installing if it detects Android 6 or newer.

To check, please bring up AquaMail settings -> mail, receiving.

If the app is not already whitelisted, there will be a green panel / button / message / prompt asking you to do this.

There are several “battery optimizer” apps (third party or things built into the phone’s software) which deliberately block the ability of apps to access the network or to work in the background.

One such app is Clean Master, I’m sure there are others.

If you use one, please try to “exclude” or “whitelist” AquaMail there.

On Samsung phones please see Phone Settings -> Device Maintenance -> Battery.

You’ll want want the “power saving mode” to be OFF.

And below that, if you scroll down, you do not want Aqua Mail to be listed in “always sleeping apps”. You may want to put it under “unmonitored apps” so it stays out of harm’s way.

There were several reports recently specific to Xiaomi MIUI:

– Apparently MIUI has some sort of “battery optimizer” thing built-in

– Which prevents apps from accessing the network when in the background

– This is in the phone’s system Settings app -> Additional Settings -> Battery & Performance -> Manage apps battery usage

Gmail and a few other apps are already whitelisted there. Not AquaMail though, so this has to be done manually.

Recent Huawei phones have a built-in “battery optimizer” too.

On my Honor 5C, it’s in the phone’s Settings app -> Advanced settings -> Battery manager -> Protected apps -> and you will want to set AquaMail to “Protected” here.

ASUS phones too have a built-in “battery optimizer” called “mobile manager”.

Please see here for screenshots.

The section you want there is labeled “auto-start manager” and Aqua Mail needs to be set to “allow”.

App feels sluggish, opening a message list takes 5-10 seconds or longer, refreshing mail takes long

Can be caused by “asking” (configuring) the app to sync and store too many messages.

Please check the app’s database size by doing Menu -> About on the app’s main screen, this will show as Messages.sqldb –

If it’s above around 70-100 megabytes, please review how many (recent) messages you’re asking the app to sync and cache (store on the device).

Two places to do this:

1 – App settings -> mail, receiving -> “messages to sync” (how many messages to keep up to date), the default is 25-50, and “messages to cache” (larger value, how many to store on the device), the default is 250.

2 – Account level overrides, optional, long press on the account -> special settings -> “enable special mail receiving settings for this account” (if on).

You should be fine with let’s say “sync = 100” and “cache = 250”, or “sync = 250” or “cache = 500”. But having “thousands” for either is very likely to cause trouble.

After scaling back the settings, please do Menu -> Compact the database on the app’s main screen, and you should see a smaller Messages.sqldb size being reported. And it should be noticeably faster too.

Recent Samsung phones, unwanted separate notification icon for each message

This is a bug in Samsung’s system software, and has to do with AquaMail enhancing its notifications
for “Android Wear”.

The intention is that they’d be mirrored by Samsung’s Gear app onto a Gear smart watch, but there is supposed to be only a single status bar notification on the phone itself.

This is how it works with real Android Wear watches, but it seems that the Gear app does too much with phone’s own notification area (sometimes)…

Please use AquaMail settings -> message notifications -> turn OFF “Support for smart watches”, and you’ll be getting a single icon / panel per *account* (as intended) not per *message*.

App doesn't 'start in smart folder'

You must be starting the app from its “message counter” widget.

There was a recent ( change where if you use the “message counter” widget that “points to” -> “all accounts”, and start the app from there, then:

previously, the app would remain in previous state, or go to the “start the app in” state (which could be the smart folder, or a specific folder)

now, it goes into the main window (account list mode), which is what the widget points to (“all accounts”), consistent with when a widget “points to” a folder.

Please remove the widget from the home screen and create a new one.

And then you can choose what the widget “points to” in the “widget config window” that is shown in the process (while creating your new widget) – please make it “smart folder” (it’s in the drop-down with the list of accounts).

Same with “start in..” regular folder, too, please be sure to choose that folder for your widget (first the account and then the folder).

The setting to turn the screen on when notifying disabled on Android 6.0+

Had to do this in 1.6.2, the feature was causing issues on Android 6.0 specifically (has worked fine since Android 2.0…)

I recommend using this app to enhance your notifications, it does have a setting to turn the screen on, and it’s been verified as working:, no folders

There are different ways to connect to

1 – IMAP, this provides access to folders, and when you move messages into Deleted, they will be moved there on the server.

2 – POP3, old technology from 1996. Does not provide access to folders, when you move to Deleted, messages will *not* be moved to Deleted on the serer. They will be deleted when you empty the Deleted folder in Aqua Mail.

Aqua Mail’s default for is POP3.


Because Libero’s IMAP is only available when the phone’s Internet connection is WiFi or certain specific mobile operators. When using other mobile operators, you’ll get an error message when the app tries to check mail.

This is not a bug in Aqua Mail, rather it’s something deliberate that Libero does, and was confirmed by their support.

To *try* using Libero over IMAP, here is how:

1 – Switch the phone to mobile data (*not* WiFi)

2 – Remove the account from Aqua Mail by long pressing on it and choosing “delete account”.

3 – Menu -> Add account -> Choose Internet Mail -> enter and password -> tap Manual, not Next.

4 – On the next screen, “incoming server settings”, please change POP3 to IMAP (near the top), and change server name from “” to “”. The security should remain SSL, and the port # will change from 995 to 993 automatically.

5 – Tap Next to go to “outgoing server settings”. It’s not necessary to change anything here.

6 – Tap Next again and the app will validate your settings. If it works, then your mobile operator is supported by Libero. If you get an error that says “IMAP4 not available”, then it’s not.

Samsung S8, app not full screen, black bars top and bottom

Strange but true. Please see the below link and enable “full screen” for Aqua Mail in the phone’s Settings app.

We already have a fix for this (Aqua Mail runs full screen, no black bars, on the S8) and hope to release it reasonably soon.

Apple iCloud accounts, two factor authentication, login failures

It seems that Apple recently started requiring “two factor authentication” and blocking access from mail apps that try to use the account’s “master” password.

Please generate an “application specific password” for Aqua Mail and use that instead of the “master” password.

We have step by step instructions here.

MacWorld has more detailed info.

Cannot send emails when device is connected to WiFi (connect / network errors)

If the WiFi in question is something at a hotel, McDonalds, etc. – public WiFi access points are often limited to web browsing traffic and block everything else.

Same often applies to office WiFi networks (corporate IT policies).

Push mail for Exchange - 'messages to sync' has to be 'date based'

Push mail for Exchange requires the “messages to sync” in that account to be set to a “date range” type value. The initial value when you add an Exchange account into the app is “21 days”.

Has to do with the technology that we use for push mail for Exchange.

Changing the “messages to sync” in an Exchange account to a “number” type value (e.g. “50 messages”) will turn off the “push mail” setting. Turning “push mail” back on will change the “messages to sync” to “21 days”.

With IMAP accounts, the technology is completely different, and there is no such requirement. In fact, for IMAP, sync by “message count” has somewhat better performance.

Unread badge on the app icon - Samsung with Android 8.0 (Oreo)

Starting with Android 8.0 (Oreo) Samsung completely changed how the “unread badge” feature works. Previously an app could directly set the badge’s value, this is not longer possible. At all.

The “new way” is managed by the phone’s software and its value is automatically taken from the app’s notifications (in the phone’s top bar).

There are two settings to check / adjust before this works.

1 – Phone settings -> Apps -> Aqua Mail -> Notifications -> enable “Show bagde”.

This however will only trigger on single-message notification, so you’ll have either nothing or a “1” on the badge.

To make it work for multiple-message notifications, please:

2 – Aqua Mail settings -> message notifications -> enable “Smart Watch enhancements”.

This also changes how on-phone notifications look. You’ll be able to expand (swipe down) on a notification that’s “about” more than one message, turning into individual “cards”, one per message, each with its own action buttons (mark read and so on).

This “enhanced” notification style – which first appeared in Android 7.0 – works with the new Samsung badge feature as expected, even when there are multiple unread messages.

PS – the badge count will clear when the app’s notifications are cleared.

New text editor in version 1.14

Version 1.14 has a new text editor (on the compose screen) with these new features suggested by users:

– Lists (with bullets or numbers)
– Paragraph alignment (left / center / right)
– When replying, editing the “original” preserves all formatting, even images

This new editor cannot have a black background for technical reasons, so in the dark theme we made the background a “muted” light gray (the light themes use pure white).

When replying or forwarding, the original message is shown as “( … )”

If you just type your new text and tap Send, the original message will be inserted where the “( … )” placeholder was.

To delete the original message just put the cursor on the next line and tap Backspace on the soft keyboard – i.e. this works just like deleting text.

To “expand” the original message for editing just tap the “( … )”. This will keep all the formatting of the original and it’ll be editable as well.

If you prefer the old editor, the new editor can be turned off in app settings -> composing and sending.