Shortcode Reference
The [mmedia_dispatch] shortcode renders a subscription
form anywhere on your site — pages, posts, widgets, or theme
templates.
Basic usage
[mmedia_dispatch]
Attributes
-
button_text— label on the submit button. Default:"Subscribe" -
placeholder— placeholder text for the email field. Default:"Your email address" -
show_name— show a first name field above the email field. Values:"yes"or"no". Default:"no" -
name_placeholder— placeholder text for the name field (only relevant whenshow_name="yes"). Default:"Your first name" -
success_message— message displayed after a successful form submission. Default:"Thanks! Check your inbox to confirm."
Examples
With a first name field and custom button label:
[mmedia_dispatch show_name="yes" button_text="Join the list" name_placeholder="First name"]
Custom success message:
[mmedia_dispatch success_message="You're in! Check your email for a confirmation link."]
How it works
- Form submits via AJAX — no page reload on success or error
-
On success, the form is replaced by the
success_messagetext - If the email is already pending or active, the subscriber receives a fresh confirmation email (pending) or a silent no-op (active)
- Duplicate submissions for unsubscribed emails are rejected — they cannot re-subscribe through this form
Styling
The form outputs minimal HTML and inherits your theme’s CSS for inputs
and buttons. The outer wrapper has the class
mmedia-dispatch-form — target this in your theme’s
stylesheet to customize spacing, font sizes, button colors, and more.
Next: Troubleshooting
Dispatch Core
Free self-hosted email marketing for WordPress. List management, SMTP, double opt-in, throttled sending, and CAN-SPAM compliance.
Quick Links
- Overview
- Requirements
- Installation
- Configuration
- Managing Campaigns
- Subscriber Management
- Shortcode Reference
- Troubleshooting
Need support?