Tahhan JMAP Mailer

FAQ

What is JMAP?

JMAP (JSON Meta Application Protocol) is a modern, open-standard protocol (RFC 8620 / RFC 8621) designed as the successor to IMAP and SMTP. It communicates over HTTPS using JSON, works through firewalls without special port configuration, and is significantly more efficient than legacy email protocols.

How is JMAP different from SMTP?

SMTP was designed in 1982 and requires specific TCP ports (25, 465, 587) that are often blocked by firewalls and hosting providers. JMAP works over standard HTTPS (port 443), requires no relay configuration, has no port restrictions, and uses a modern JSON-based API that is far easier to work with programmatically.

Which mail servers support JMAP?

Stalwart Mail Server, Fastmail, Cyrus IMAP, and Apache James all support JMAP fully. Any server implementing RFC 8621 will work with Tahhan JMAP Mailer.

Does Tahhan JMAP Mailer work with WooCommerce?

Yes. Tahhan JMAP Mailer includes WooCommerce email type detection. You can create routing rules that detect WooCommerce emails (order confirmations, customer invoices, admin notifications) and route them to a dedicated transactional email account for better deliverability.

Can I use multiple JMAP accounts?

Yes. The Accounts tab lets you configure multiple JMAP accounts. You can set one as the Primary account (used by default) and configure additional accounts such as a dedicated transactional account for WooCommerce or a support-specific account.

How do routing rules work?

Routing rules are evaluated in order from top to bottom. The first matching rule wins. Each rule can match on recipient email, recipient domain, sender email, subject content, or plugin/email type. You can match ANY condition (OR logic) or ALL conditions (AND logic). Non-matching emails fall back to the Primary account.

What is the retry queue?

When an email fails to send, Tahhan JMAP Mailer can automatically retry it via WP-Cron. You configure the maximum number of retry attempts (1-5) and an initial delay (5 minutes to 1 hour). Each subsequent retry doubles the delay (exponential backoff). Permanently failed emails are marked as “exhausted” in the mail log.

What is open tracking?

Open tracking embeds a 1×1 transparent pixel in outgoing HTML emails. When a recipient opens the email, the pixel loads from your WordPress site, recording the open event. Plain-text emails are never tracked. All tracking data stays on your own server — nothing is sent to external services. You should disclose tracking in your privacy policy.

What is the mail log?

The mail log records every send attempt: timestamp, recipient address, subject line, send status (sent/failed), JMAP account and identity IDs, email object ID, and any error message. Message bodies, CC/BCC addresses, and attachment contents are never stored. The log is capped at 100 entries.

Can I export the mail log?

Yes. On the Mail Log tab, click “Export CSV” to download all log entries as a CSV file. The export includes timestamp, recipient, subject, status, account ID, identity ID, email ID, and error message.

What PHP version is required?

PHP 7.4 or higher. The plugin is tested with PHP 7.4, 8.0, 8.1, 8.2, and 8.3.

What WordPress version is required?

WordPress 5.8 or higher. The plugin is tested up to WordPress 6.7.

What is the Primary account?

The Primary account is the fallback account used for all emails that do not match a routing rule. It is created automatically during setup from your initial JMAP credentials. You can edit the Primary account’s credentials on the Connection tab or in the Accounts tab.

How do sender identities work?

A JMAP identity defines the “From” name and email address used when sending. Tahhan JMAP Mailer can auto-resolve the correct identity by matching your configured From Email to an identity on the JMAP server. You can also manually select a specific identity from the Connection tab by clicking “Load identities” after saving your credentials.

How do I test the connection?

Go to Tahhan JMAP Mailer -> Connection and click “Test connection”. The plugin will discover the JMAP session, resolve your sender identity, and verify server capabilities. You can also click “Send test email” to fire a real email through the full send pipeline to your configured test recipient.