Web Forms

Create and manage online forms to capture leads, gather subscriber information, or collect feedback from your audience. Customize form fields, design layouts, and integrate with your email campaigns for seamless data collection and management.

Overview

Web forms handle the complete subscription workflow:

+------------------+      +------------------+      +------------------+
|  VISITOR FILLS   | ---> |  FORM SUBMITTED  | ---> |  CONTACT ADDED   |
|  WEB FORM        |      |  (validation)    |      |  TO LIST         |
+------------------+      +------------------+      +------------------+
                                                           |
                                         +-----------------+-----------------+
                                         |                                   |
                                         v                                   v
                                +------------------+                +------------------+
                                |  SINGLE OPT-IN   |                |  DOUBLE OPT-IN   |
                                |  Status:Confirmed|                |  Status:Unconfirm|
                                +------------------+                +------------------+
                                                                           |
                                                                           v
                                                                   +------------------+
                                                                   |  CONFIRMATION    |
                                                                   |  EMAIL SENT      |
                                                                   +------------------+
                                                                           |
                                                                           v
                                                                   +------------------+
                                                                   |  CLICK CONFIRM   |
                                                                   |  Status:Confirmed|
                                                                   +------------------+

---

Why Use Web Forms

Lead Capture

• Grow your list - Convert website visitors to subscribers
• Collect data - Gather custom field information
• Qualify leads - Use double opt-in for quality subscribers

Compliance

• GDPR compliance - Document consent with double opt-in
• CAN-SPAM compliance - Verify subscriber intent
• Proof of consent - Track subscription source and time

Automation

• Automatic list addition - No manual data entry
• Trigger workflows - Start drip campaigns on signup
• Send confirmations - Automated welcome emails

---

Viewing Web Forms

Navigate to Setup → Web Forms to view all forms.

Page Features

• Add New button to create a form
• Templates button to browse form templates
• Bulk Actions dropdown for batch operations
• Our records / User records toggle to filter view
• Filter by admin dropdown to filter by administrator
• Show entries dropdown to control page size
• Search box to find specific forms

Table Columns

Column	Description
Form Name	Name of the web form
Require email confirmation	Yes/No - Double opt-in status
Thank You Email	Yes/No - Welcome email enabled
Created on	Date and time form was created
Actions	Row action menu

Row Actions

Click the ... (three dots) menu on any row to access:

Action	Description
Edit	Modify form settings
Get HTML	View and copy form HTML code
View Form	Preview the form in browser
Download	Download form as file
Make a Copy	Duplicate this form
Copy Post URL	Copy the form submission URL
Delete	Remove this form

---

Form Templates

Before creating a form, you can choose from pre-designed templates.

Accessing Templates

1. Click Templates button on the Web Forms page, OR
2. Click Add New to start the creation wizard

Template Gallery

The template gallery displays:

• Search templates - Filter templates by name
• Template thumbnails - Visual preview of each design
• Template names - Identifying labels

Available Template Types

Template Type	Description
Blank Template	Start from scratch with no styling
Subscriber Form	Simple email subscription form
Contact Form	Full contact information form
Subscribe Form Minimal	Clean, minimalist design
Subscribe Form with Background	Form with background image
Contact Form with Address	Extended form with address fields
Campaign Monitor Style	Inspired by Campaign Monitor designs

Using a Template

1. Browse the template gallery
2. Click on a template thumbnail to select it
3. The form editor opens with the template applied
4. Customize fields and settings as needed

---

Creating a Web Form

Navigate to Setup → Web Forms and click Add New.

The form creation wizard has 4 steps:

Step	Title	Description
1	Form Details	Details and settings
2	Email Confirmation	Double opt-in settings
3	Welcome Email	Welcome settings
4	Error	If error occurs

---

Step 1: Form Details

Configure the basic form settings and field selection.

Template Selection

If you selected a template, you'll see:

• Current Template preview thumbnail
• Change template link to select a different design

Form Name

Enter a descriptive name for your web form.

Examples:

• "Newsletter Signup"
• "Blog Subscription Form"
• "Footer Opt-in"

Require Email Confirmation

Toggle to enable double opt-in (optional).

When enabled (Double Opt-in):

1. Visitor submits form
2. Contact is added to the list with Unconfirmed status
3. Confirmation email is sent
4. Visitor clicks confirmation link
5. Contact status is updated to Confirmed

When disabled (Single Opt-in):

1. Visitor submits form
2. Contact is added to the list with Confirmed status immediately

Contact Addition

In both cases, the contact is added to Mumara as soon as the form is submitted. The difference is the initial status: Unconfirmed (awaiting confirmation) vs Confirmed (ready to receive campaigns).

Best Practice

Enable double opt-in for better list quality and compliance. Unconfirmed contacts can still be managed but won't receive campaigns until they confirm.

Send Thank You Email

Toggle to send a welcome email after subscription is confirmed.

Google reCAPTCHA

Toggle to enable spam protection with Google reCAPTCHA.

When enabled:

Field	Description
Version	Select V2 or V3
Public Key	Your reCAPTCHA site key
Secret Key	Your reCAPTCHA secret key

reCAPTCHA V2 vs V3:

Version	Description
V2	Shows "I'm not a robot" checkbox
V3	Invisible verification based on behavior score

Send Notification

Toggle to receive email notifications when someone subscribes.

When enabled:

Field	Description
Notification email	Email address to receive notifications
Notification email content	Rich text editor for notification body
Notification email subject	Subject line for notifications

Available notification variables:

• %%list_name%% - Name of the contact list
• %%webform_name%% - Name of the web form
• %%app_title%% - Application name

Email Format

Select how subscribers receive emails:

Option	Description
Allow subscribers to choose	Form shows format selection
HTML	All subscribers receive HTML emails
Text	All subscribers receive plain text

Duplicates

Configure how to handle existing contacts:

Option	Description
Skip	Don't add if email already exists
Update	Update existing contact with new data

Sending Nodes

Select one or more sending nodes for confirmation and thank you emails.

• Nodes are grouped by their configured groups
• Check Select all to use all nodes
• Select specific nodes for load balancing

warning

At least one sending node must be selected.

Contact List

Select the contact list where new contacts will be added.

• Lists show contact count in parentheses
• Lists missing sending domain show MISSING SENDING DOMAIN warning
• Click Fix Now to configure the sending domain

Missing Sending Domain

Lists without a configured sending domain cannot be used. Configure the sending domain in Setup → Sending Domains first.

Form Fields

Select and arrange the fields that appear on your form.

Default field:

• Email - Always included (required)

Selecting custom fields:

1. Select a contact list
2. The list's custom fields appear as checkboxes
3. Check the fields you want to include
4. Selected fields appear in the Form fields section

Field Ordering (Drag and Drop)

Arrange fields by dragging them in the Form fields list.

Field Order

The order of fields in this list determines the order they appear in the web form HTML code. Drag fields up or down to rearrange them.

How it works:

1. Selected fields appear in the Form fields panel
2. Each field has a drag handle (bullet point)
3. Click and drag a field to reposition it
4. The new order is saved automatically
5. Generated HTML reflects the field order

Click Continue to proceed to Email Confirmation settings.

---

Step 2: Email Confirmation

Configure double opt-in confirmation settings.

Redirect After Submission

Choose what happens after form submission:

Option	Description
Show confirmation page	Display a built-in confirmation message
Redirect to another webpage	Send visitor to external URL
Show JSON response	Return JSON data (for AJAX forms)

Confirmation Page Content

Rich text editor for the confirmation message shown after form submission.

Default message:

You're almost subscribed! We've sent a confirmation email to the address you provided. Please click the link inside to complete your subscription. Thank you!

Sender Information

Configure who the confirmation email appears to be from:

Field	Description
Sender name	Display name (e.g., "Company Newsletter")
Sender email	From email address
Reply-to email	Where replies are sent
Email subject	Subject line (e.g., "Confirm your subscription!")
Bounce email	Select bounce address for failed deliveries

Confirmation Email HTML Content

Rich text editor for the HTML version of the confirmation email.

Required element: Include the confirmation link tag %%confirmurl%%

Variable buttons available:

• General Variables - System variables
• Recipient Fields - Subscriber data fields
• Spintax - Spin text variations
• Dynamic Content Tags - Conditional content
• Profile Variables - Admin profile fields
• Copy as Text - Copy content as plain text

Example content:

Dear Subscriber,

You're almost there! Just one click to confirm your subscription.

[Confirm Subscription]

Or, copy and paste this link into your browser:
%%confirmurl%%

Best Regards,
%%application_name%%

Confirmation Email Text Content

Plain text version for email clients that don't support HTML.

Click Continue to proceed to Welcome Email settings.

---

Step 3: Welcome Email

Configure the welcome/thank you email sent after confirmation.

Redirect Subscriber To

Choose what happens after subscription is confirmed:

Option	Description
Show thank you page	Display a built-in thank you message
Redirect to another webpage	Send to external URL (e.g., download page)

Thank You Page Content

Rich text editor for the thank you message.

Example:

Welcome to the Community! We're thrilled to have you join our contact list. Get ready for exciting updates, exclusive offers, and valuable insights delivered straight to your inbox. Stay tuned!

Sender Information

Field	Description
Sender name	Display name for thank you email
Sender email	From email address
Reply-to email	Where replies are sent
Email subject	Subject line (e.g., "Thank you for your subscription!")
Bounce email	Select bounce address

Email HTML Content

Rich text editor for the HTML thank you email.

Variable buttons available:

• General Variables
• Recipient Fields
• Spintax
• Dynamic Content Tags
• Profile Variables
• Copy as Text

Email Text Content

Plain text version of the thank you email.

Click Continue to proceed to Error settings.

---

Step 4: Error Handling

Configure what happens when an error occurs during subscription.

In Case of an Error

Option	Description
Show error page	Display a built-in error message
Redirect to another web page	Send to external error page

Error Page Content

Rich text editor for the error message.

Default content:

An error has occurred during the subscription:

%%error%%

Available variable:

• %%error%% - The specific error message

Variables button - Insert available variables

Click Submit to save the web form.

---

Getting Form HTML

After creating a form, get the HTML code to embed on your website.

Get HTML Code

1. Click ... menu on a form row
2. Select Get HTML
3. A modal displays the Subscription Form HTML
4. Copy the code from the Web Form HTML textarea

HTML Code Structure

The generated HTML includes:

<form id="webform"
      action="https://yoursite.com/web-forms/subscription-data"
      method="POST"
      class="kt-form kt-form--label-right">

  <!-- Hidden fields -->
  <input type="hidden" name="list_id" value="1234">
  <input type="hidden" name="key_" value="unique_key">
  <input type="hidden" name="webform_id" value="78">

  <!-- Form fields in configured order -->
  <div class="form-group row">
    <label class="col-form-label col-md-3">Email</label>
    <div class="col-md-8">
      <input type="email" name="email" class="form-control">
    </div>
  </div>

  <!-- Additional custom fields -->
  <!-- Submit button -->
</form>

---

Managing Web Forms

Editing a Form

1. Click ... menu → Edit
2. Navigate through the 4-step wizard
3. Modify settings as needed
4. Click Submit to save changes

Viewing a Form

1. Click ... menu → View Form
2. Form opens in a new browser tab
3. Test the form appearance and functionality

Downloading a Form

1. Click ... menu → Download
2. Form files are downloaded as a package

Copying a Form

1. Click ... menu → Make a Copy
2. A new form is created with "(copy)" suffix
3. Edit the copy as needed

Copying Post URL

1. Click ... menu → Copy Post URL
2. The form submission URL is copied to clipboard
3. Use this URL for custom form implementations

Deleting a Form

1. Click ... menu → Delete
2. Confirm deletion

---

Email Variables

The confirmation and thank you email editors provide access to the same variables available in broadcasts. Use the variable buttons below the editor to insert dynamic content.

Variable Categories

Button	Description
General Variables	System and sender information
Recipient Fields	Contact's custom field data
Spintax	Spin text variations
Dynamic Content Tags	Conditional content based on field values
Profile Variables	Admin profile fields
Copy as Text	Copy HTML content as plain text

---

General Variables

Variable	Description
Sender Name	The configured sender name
Sender Email	The configured sender email address
Recipient Email	The subscriber's email address
Reply-to Email	The configured reply-to address
Bounce Email	The configured bounce email address
Today's Date	Current date
Message id	Unique message identifier
Campaign id	Campaign identifier
Sending Domain	The sending domain used
Tracking Domain	The tracking domain used
Schedule id	Schedule identifier
Confirmation Link	Double opt-in confirmation URL (required for confirmation emails)
Unsubscribe Link	Unsubscribe URL

---

Recipient Fields

Insert custom field values for the subscriber. Available fields depend on the contact list's configured custom fields.

Examples:

• First Name
• Last Name
• Company
• Phone
• Any custom fields defined for the list

---

Spintax

Insert spin text variations that rotate between options. Select from pre-configured spintax groups.

Example spintax groups:

• Greetings (dear, hello, hi)
• Salutations
• Custom spintax groups

See Spintax for more details on creating and using spintax.

---

Dynamic Content Tags

Insert conditional content that displays based on custom field values. These tags allow you to show different content depending on subscriber data.

Available conditions:

Condition Type	Description
custom-field-{name}	Show if field has value
custom-field-{name}-isnt	Show if field is empty
custom-field-{name}-contains	Show if field contains value
custom-field-{name}-dosnt-contains	Show if field doesn't contain value

See Dynamic Content Tags for detailed usage.

---

Profile Variables

Insert admin profile field values.

Variable	Description
Email	Admin email address
Name	Admin name
Country	Admin country
Mobile	Admin mobile number
Address Line 1	Admin address line 1
Address Line 2	Admin address line 2
City	Admin city

---

Notification Email Variables

For admin notification emails when someone subscribes:

Variable	Description
%%list_name%%	Contact list name
%%webform_name%%	Web form name
%%app_title%%	Application title

---

Error Page Variables

Variable	Description
%%error%%	The specific error message

---

Available Field Types

When selecting custom fields for your form, the following types are supported:

Field Type	Description
Text Field	Single-line text input
Numeric	Numeric input only
Multiline Text Field	Multi-line text area
Checkboxes	Multiple selection checkboxes
Dropdown	Single selection dropdown list
Radio Options	Single selection radio buttons
Date Field	Date picker input

---

Best Practices

Form Design

• Keep it simple - Only ask for necessary information
• Clear CTA - Use action-oriented button text
• Mobile friendly - Test on mobile devices
• Fast loading - Minimize form complexity

Double Opt-in

• Always use - For quality and compliance
• Clear messaging - Explain what to expect
• Quick confirmation - Send immediately
• Easy to find - Make confirm link prominent

Spam Protection

• Enable reCAPTCHA - Prevent bot submissions
• Use V3 - Better user experience than V2
• Monitor submissions - Watch for suspicious patterns

Compliance

• Privacy policy link - Include on form
• Terms acceptance - Checkbox if needed
• Clear consent - Explain what they're subscribing to
• Easy unsubscribe - Include in all emails

Conversion

• Value proposition - Explain benefits
• Social proof - Show subscriber count
• Incentive - Offer lead magnet
• Minimize friction - Fewer fields = more signups

---

Troubleshooting

Form Not Submitting

Possible causes:

• JavaScript errors on page
• Form action URL incorrect
• Required fields not filled
• reCAPTCHA validation failed

Solutions:

• Check browser console for errors
• Verify form HTML is complete
• Check field validation
• Verify reCAPTCHA keys are correct

Confirmation Email Not Received

Possible causes:

• Email in spam folder
• Sending node issue
• Invalid email address
• Missing sending domain on list

Solutions:

• Check spam/junk folder
• Verify sending node is working
• Test with different email address
• Configure sending domain for the list

Contact Not Added to List

Possible causes:

• Duplicate handling set to Skip
• Confirmation link not clicked
• List is missing sending domain

Solutions:

• Check duplicate settings
• Verify confirmation was completed
• Configure sending domain for the list

reCAPTCHA Not Working

Possible causes:

• Invalid public or secret key
• Domain not registered in reCAPTCHA console
• Version mismatch

Solutions:

• Verify keys in Google reCAPTCHA admin
• Add your domain to allowed domains
• Ensure correct version is selected

Redirect Not Working

Possible causes:

• Invalid redirect URL
• CORS restrictions
• Form submission error

Solutions:

• Verify URL is complete (include https://)
• Check for CORS issues
• Review form submission logs

---

Next Steps

• Contact Lists - Create lists for form submissions
• Custom Fields - Add fields to forms
• Triggers - Automate actions on signup
• Drip Campaigns - Start sequences for new subscribers