Subscribe Forms

Updated on February 9, 2026

Subscribe forms let you add email signup forms to any page or post on your site using a shortcode. When a visitor enters their email and submits the form, they are added to Mautic as a contact with the tags you specify. The form submits via AJAX, so the page does not reload.

Enabling Subscribe Forms

  1. Go to WooCommerce > Mautic Integration and click the Contact Sync tab.
  2. Scroll down to the Subscribe Forms section.
  3. Check the box labeled Enable the [mautic_woo_subscribe] shortcode.
  4. Click Save Changes.

Basic Usage

Add the shortcode to any page, post, or widget that supports shortcodes:

[mautic_woo_subscribe]

This renders a simple form with an email input field and a “Subscribe” button. When submitted, the email is sent to Mautic and tagged with the default tag configured in settings.

Shortcode Attributes

You can customize each form using the following attributes:

  • tag – A tag to apply to contacts captured by this specific form. This is added alongside the global default tag, not instead of it. Example: tag="newsletter"
  • text – The text displayed on the submit button. Defaults to “Subscribe”. Example: text="Join Now"
  • placeholder – The placeholder text inside the email input field. Defaults to “Email address”. Example: placeholder="Enter your email"
  • consent – When provided, a consent checkbox is shown below the email field with this text as the label. The form will not submit unless the checkbox is checked. Example: consent="I agree to receive marketing emails"

Full Example

Here is a shortcode using all available attributes:

[mautic_woo_subscribe tag="newsletter" text="Join Our List" placeholder="Your email" consent="I agree to receive marketing emails"]

This displays a form with a custom placeholder, a consent checkbox, and a “Join Our List” button. The contact will receive both the “newsletter” tag and the global default tag.

Default Tag

The Default Tag setting in the Subscribe Forms section applies to all subscribe form submissions. It defaults to subscriber. You can change this to any tag you prefer. If you also specify a tag attribute on the shortcode, both tags are applied to the contact.

How Submission Works

When a visitor submits the form:

  1. The form validates the email address on the client side (the email field uses HTML5 validation).
  2. If a consent checkbox is present, it must be checked or the form shows a “Please check the consent box” message.
  3. The submit button is disabled to prevent double submissions.
  4. The email and tag are sent to your server via AJAX.
  5. The server validates the email again, then sends the contact data to Mautic.
  6. A success or error message appears below the form.
  7. On success, the email field is cleared so the visitor knows the submission went through.

The form works for both logged-in users and guest visitors. No WordPress account is needed to subscribe.

Styling

The form uses the CSS class mautic-woo-subscribe-form and loads a default stylesheet. You can override the styles in your theme’s CSS to match your site’s design. The success message uses the class success and the error message uses error on the result span element.

Next

Form Capture