Skip to content
CMS Max Documentation

Mailgun

Reliable transactional email delivery for your CMS Max website

Overview

The Mailgun plugin handles email delivery for your CMS Max site through Mailgun, a transactional email service. All system emails — such as form notifications, order confirmations, and password resets — are sent through Mailgun.

How It Works

By default, your site sends emails through the CMS Max shared Mailgun account. This requires no configuration on your part. Emails are sent from no-reply@cmsmax.com (or your CMS Max platform domain).

If you want emails to come from your own domain, you can connect your own Mailgun account.

Setup

  1. Navigate to Settings > Plugins
  2. Find Mailgun and click to open the settings page
  3. Click Save and Install

The plugin is pre-configured to use the CMS Max Enterprise License (shared account). No further action is needed unless you want to use your own Mailgun account.

Configuration

Domain Selection

Mailgun plugin settings

Option Description
CMS Max Enterprise License Uses the shared CMS Max Mailgun account. Emails are sent from the CMS Max platform domain. No credentials required.
Custom Uses your own Mailgun account. Emails are sent from your domain. Requires your Mailgun API credentials.

Custom Domain Settings

When you select Custom as the domain option, three additional fields appear:

Mailgun custom domain settings

Field Description
Custom Domain Your verified Mailgun sending domain (e.g., mg.yourdomain.com)
Secret Key Your Mailgun API secret key
Public Validation Key Your Mailgun public validation key

Switching to Your Own Mailgun Account

  1. Sign up at mailgun.com
  2. Add and verify your sending domain in the Mailgun dashboard
  3. In the CMS Max plugin settings, change Domain to Custom
  4. Enter your Custom Domain, Secret Key, and Public Validation Key
  5. Click Save

Email Plugin Exclusivity

Only one email delivery plugin can be active at a time. If another email plugin (such as Postmark or SMTP) is currently active, you must deactivate it before activating Mailgun.

Troubleshooting

Emails are not being delivered

  • Confirm the Mailgun plugin is installed and active in Settings > Plugins
  • If using a custom domain, verify it is fully configured in your Mailgun dashboard (SPF, DKIM, and DMARC DNS records)
  • Check that no other email plugin is active at the same time

Emails are going to spam

  • Verify your DNS records are properly configured (SPF, DKIM, DMARC) in your domain registrar
  • If using the CMS Max shared account, ask recipients to add the sending address to their contacts

Emails show the wrong "from" address

  • When using the CMS Max Enterprise License, emails come from the platform domain
  • To send from your own domain, switch to the Custom domain option and configure your Mailgun credentials