StackMime Forms documentation

1. Download the zip from the product page, or search for “StackMime Forms” under Plugins → Add New once it is listed on WordPress.org.
2. For the zip, go to Plugins → Add New → Upload Plugin, choose the file and click Install Now.
3. Click Activate. A ready Contact form is created for you, and a one-time notice links to the Getting started guide.

Open Forms → All forms. Edit the Contact form, or create a new one from a template: Contact, Quote request, Call-back request, Booking request, Feedback or a blank form.

In the builder you can add, edit, reorder (drag, or use the arrow buttons) and duplicate fields, with a live preview beside them. Set two fields to Half width to put them side by side; on phones they stack.

There are 12 field types: text, email, phone, paragraph, dropdown, single choice, checkboxes, number, date, website, consent checkbox, and heading-and-text sections.

Edit any page, add the StackMime Form block and choose your form. Or paste the shortcode shown next to the form:

	

											

									Your name *
																	
																	
			
											

									Email *
																	
																	
			
											

									Phone
																	
																	
			
											

									How can we help? *
											
																	
			
				
Leave this empty 
		

			Send message
			

		
		
	
	

Under Forms → Settings, set the address that receives new entries. Each alert is a clear HTML email with Reply-To set to the sender and a unique subject, so mail apps don’t merge entries into one thread.

The auto-reply confirms to the sender that you received their message. Write it once in Settings, or per form. Placeholders work in subjects and the auto-reply: {name}, {site}, {entry} and any field key, such as {company}.

Every entry is saved under Forms → Entries before any email is sent, so you never lose a lead. The inbox has unread, spam and trash views, search, a form filter and bulk actions.

Open an entry to see its email alert status. If delivery failed, click Resend. Export entries as a CSV that opens cleanly in Excel or Google Sheets.

There is no CAPTCHA. Instead, each form uses a signed one-time token, a minimum time on the page, a hidden honeypot field, a per-visitor rate limit and a limit on links. Real visitors never notice.

Bots get a normal-looking reply, so they learn nothing. Suspected spam is kept in the Spam view for 30 days, so nothing is lost by mistake.

Under Forms → Settings, choose Clean (uses your theme’s fonts and primary colour) or No styles, and set an accent colour. In your theme you can also override the CSS custom property --smf-accent and the .sm-form classes.

Register a form in code:

add_action( 'stackmime_forms_init', function () {
	stackmime_forms_register( 'quote', array(
		'title'  => 'Quote request',
		'fields' => array(
			'name'  => array( 'label' => 'Name', 'type' => 'text', 'required' => true ),
			'phone' => array( 'label' => 'Phone', 'type' => 'tel', 'required' => true ),
		),
	) );
} );

Send from your own markup with JavaScript:

StackMimeForms.submit( 'quote', { name: 'Sara', phone: '+44 20 0000 0000' } )
	.then( function ( res ) { console.log( res.ok, res.message ); } );

Run code after each entry is saved with the stackmime_forms_submitted action, which receives the entry ID, the form ID and the cleaned fields.

Alerts don’t arrive

Check the entry under Forms → Entries: its alert status shows whether sending failed. Most servers’ default mail is filtered as spam; connect an SMTP service with StackMime Mail.

The form doesn’t send on a cached page

It should: forms get a fresh token from the REST API and are sent with POST, which caches never store. If your security plugin blocks the REST API for visitors, allow the stackmime-forms/v1 routes.

“Please turn on JavaScript”

Forms are sent with a small script. Visitors with JavaScript switched off see this message instead of a form that can’t send.

Visitor IP addresses are never stored, only a one-way hash used for rate limiting. You can delete old entries automatically in Settings.

Deleting the plugin removes nothing unless you switch on Delete all forms, entries and settings when the plugin is deleted.

2.0.1

• New: a Getting started guide and a one-time welcome notice after a fresh install (no redirect).

2.0.0

• New: form builder with live preview, drag-and-drop ordering and templates.
• New: the StackMime Form block.
• New: single choice, consent, website and heading-and-text fields, half-width fields and help text.
• New: a cleaner admin with an entries inbox and settings screen.
• Fixed: forms on sites with plain permalinks.

1.0.5

• Unique notification subjects so mail apps don’t merge entries into one thread.

1.0.0

• First release.