How to Report a Bug or Request a Feature in Airmail

Problem

You've found a bug in Airmail or want to suggest a new feature.

Reporting a Bug

Via Crisp Chat (Recommended)

1. Visit airmailapp.com
2. Click the chat icon in the bottom-right corner
3. Describe your issue with as much detail as possible
4. Include: your device, OS version, Airmail version, and email provider

Via Email

1. Send an email to the Airmail support team
2. Include screenshots or screen recordings if possible
3. Mention the steps to reproduce the bug

What to Include in a Bug Report

• Device — Mac model, iPhone/iPad model
• OS Version — macOS 14.x, iOS 17.x, etc.
• Airmail Version — Found in Airmail → About Airmail (Mac) or Settings → About (iOS)
• Email Provider — Gmail, iCloud, Outlook, etc.
• Steps to Reproduce — Exactly what you did before the bug occurred
• Expected vs Actual — What should happen vs what actually happens
• Frequency — Does it happen every time or intermittently?

Requesting a Feature

1. Use the same Crisp chat or email channel
2. Describe what you'd like Airmail to do
3. Explain your use case — why this feature would help you
4. The development team reviews all feature requests

Checking Airmail Version

• Mac — Airmail menu → About Airmail
• iPhone/iPad — Airmail Settings → About