Enhanced mailbox support for World of Warcraft.
Postal replaces and extends the default mailbox UI with batch operations, one-click looting, contact management, and much more. Every feature is modular — enable only what you need from the in-game dropdown menu on the mailbox frame.
Based on the original Postal addon, updated and maintained for modern WoW clients by the community.
| Version | Interface | Status |
|---|---|---|
| Retail (Midnight) | 120001 | ✅ Primary target |
| TBC Classic Anniversary | 20505 | ✅ Supported |
| Classic Era (Vanilla) | 11508 | ✅ Supported |
| Mists of Pandaria Anniversary | 50502 | ✅ Supported |
| Wrath of the Lich King Classic | 30403 | |
| Cataclysm Classic | 40402 |
All container and item APIs use cross-version compatibility wrappers, so a single codebase runs on every client.
A button that collects all attachments and gold from your inbox in one click. Includes filters for AH cancelled/expired/outbid/sold/won mail, postmaster deliveries, and general attachments. Shift-click the button to override all filters and take everything. Automatically refreshes the mailbox when more mail is waiting on the server.
Adds checkboxes to the inbox for batch open and return operations. Shift-click two checkboxes to mass-select every mail in between. Ctrl-click a checkbox to select/deselect all mail from that sender. Skips CoD and GM mail automatically.
Mouse-click shortcuts for mail. Shift-click to take an item or money from a message. Ctrl-click to return mail to the sender. Alt-click an item in your bags to attach it to the current outgoing mail. Ctrl-click a bag item to bulk-attach similar items. Includes multi-item tooltips for messages with more than one attachment.
Contact list with auto-complete. Automatically fills the recipient field from your recent contacts, friends list, guild roster, and alts across all characters. Contacts can be manually added and managed.
Send gold to other characters quickly, directly from the mailbox UI.
Quickly attach trade goods to outgoing mail — cloth, herbs, ore, leather, enchanting materials, gems, and more. Configurable per bag slot. Recognizes trade good categories across all WoW versions.
Displays a running total of gold collected during your mailbox session.
Forward mail (including attachments) to another character. Automatically moves items through your inventory to the outgoing mail.
Copy the subject and body text of a received mail for easy forwarding or record-keeping.
Mark specific mail types to skip when using Open All, giving you finer control over what gets looted.
Blocks incoming trade requests while the mailbox is open, preventing accidental interruptions.
- Long subject tooltips — hover over truncated subject lines to see the full text
- Configurable opening speed — adjust the delay between processing each mail (0.00s to 5.00s)
- Profile system — per-character profiles with copy, reset, and default options
- Chat output control — choose which chat frame receives Postal messages
- Verbose/quiet mode — toggle chat spam during batch operations
- Search for Postal on CurseForge or Wago Addons.
- Install via the CurseForge or Wago app, or download manually.
- Make sure to select the correct game version (Retail, TBC Anniversary, Classic Era, etc.).
- Download the latest release from GitHub Releases.
- Extract the folder into your WoW AddOns directory. For Retail:
For other clients, use the appropriate game folder (
World of Warcraft/_retail_/Interface/AddOns/Postal/_anniversary_,_classic_era_, etc.). - At the character select screen, click AddOns and ensure Postal is enabled.
- Open a mailbox in-game. Use the dropdown arrow button at the top-right of the mail frame to configure modules and options.
- On TBC Anniversary,
GetInboxHeaderInfodoes not reliably return thewasReadflag. Postal works around this by checking inbox count instead. - The
MAIL_CLOSEDevent does not fire on TBC Anniversary. Postal usesPLAYER_INTERACTION_MANAGER_FRAME_HIDEorMailFrame:OnHidehooks as alternatives. - Blizzard's
OpenAllMailbutton may not exist on all clients. Postal handles this gracefully with nil guards. - If you encounter errors with container or item APIs on a specific client, please report them with your WoW version.
Please report issues on the GitHub Issues page. When reporting bugs, include:
- Your WoW client version (e.g., Retail 12.0.1, TBC Anniversary 2.5.5)
- Your locale (e.g., enUS, deDE)
- Postal version number (visible in the Help/About panel)
- The full error message, if any
Maintainer: paradosi@Dreamscythe
Original Postal authors: Ammo, Rabbit, Grennon, Mikk, oscarucb, Jonny (The_Original_Manbot)
- Ace3 — AceAddon, AceDB, AceEvent, AceHook, AceLocale (bundled)
MIT. See LICENSE.txt.
