Skip to content
CMS Max Documentation

Forms

How to create, embed, and manage forms on your CMS Max website, including contact forms, payment forms, and file uploads

Overview

Forms let you collect information from your website visitors — contact inquiries, job applications, bill payments, event registrations, and more. CMS Max includes a built-in form builder that handles submissions, notifications, and file uploads without needing any external tools.

Forms list

Editing Form Fields

Open a form and select the Fields tab. Adding or duplicating a field opens the new field and keeps the other fields expanded or collapsed as you left them. Your browser remembers these choices for saved fields when you return to the form.

A duplicated field starts without a label. Give it one before saving. Fields placed in a form group, or shown only for another field's answer, stay with the original field. Renaming a field keeps the fields that point at it. Deleting a form group moves its fields to the group it was in, or out of groups, and they keep the deleted group's Visibility rule. A field can hold one visibility rule, so a field that already had a different one, or a group whose rule was still waiting for a field, asks you to pick one before saving. A message names the deleted group's rule and any rule those fields had. Deleting a field that other fields are shown for clears their Visibility field, so pick another field or turn visibility off on each of them before saving.

Radio and checkbox option images

For a radio or checkbox field, select an image from the media library for each option that needs one. Hide option text when an image is present and Hide radio buttons and checkboxes when an image is present appear when at least one option has an image. Both are on by default. For fields that already have images, saved off values are preserved. Turn off the text setting to show option names below images. Option names remain available to screen readers, and options without images keep their visible names. Use Spread across how many columns? to choose one to five columns on larger screens; options remain in one column on smaller screens.

Removing the last option image hides both settings. Adding the first image to a field with no images turns both settings on, including for existing forms. Adding or replacing images while the field already has images keeps your current choices.

Use Choose Image to select or replace an option's image, or Remove Image to clear it. Save the form to keep your changes. Changing the field to Select clears its option images when saved. Types without options retain inactive option data for switching back; those images are not displayed or validated while inactive. Exported form fields omit image references; choose images again after importing into a site. The option rows share one media picker, and saved image previews load together in batches.

The selected image appears immediately. If Adding image... is shown, wait for it to finish before saving. You can remove the selection while it is loading; if adding the image fails, the previous selection is restored.

Image options display as selectable cards with a border around the selected option. When option text is shown, it appears below the image. The radio button or checkbox is hidden by default; turn off Hide radio buttons and checkboxes when an image is present to show it to the left of the image and text. Hidden controls remain keyboard-accessible, with a visible focus outline; in forced-colors mode, the native control is visible. Options without images keep their normal controls.

Option images keep their proportions and fit within the option column, with a maximum width and height of 250 pixels. Smaller images retain their original size.

If an option image cannot load or the visitor's browser cannot display its format, the option name and control are shown so the choice remains usable.

Themes can style the images using .form-option-image and the option text using .form-option-text. The surrounding elements use .form-options-grid, .form-option-control, and .form-option-label; image options also have .form-option-control--with-image, and options with hidden controls have .form-option-control--hide-input.

Submission Email Wording

The subject and wording of the submission alert to your team and of the confirmation email to the person who submitted the form are on Template > Email Templates, under Form Submission Alert and Form Submission Confirmation. Every form shares them. A form with Custom Admin Notify Subject or Custom Confirmation Subject on, on its Settings tab, uses its own subject instead. See Email Templates.

Conditional Fields in Submission Emails

On a form's Settings tab, under Email notifications, use Show hidden conditional fields in emails to choose whether the field lists in admin notification and user confirmation emails include fields the visitor did not see because of conditional logic.

The toggle is on by default. Turn it off and save the form to omit hidden conditional fields from emails for new submissions, including fields inside hidden form groups. Visible fields with empty answers are still included. Custom subject templates keep using saved answers. This setting only controls the email field list; saved submission details, exports, and webhooks retain all fields.

Visibility is recorded when the visitor submits, so later changes to field conditions do not change which fields were hidden in that submission. Older submissions without recorded visibility keep all their fields in emails.

Embedding a Form on a Page

Once you have created a form, you can display it on any page in two ways:

On-Page Embedding

The form appears directly within the page content:

  1. Open the page editor.
  2. Place your cursor where you want the form to appear.
  3. Click Insert Widget in the editor toolbar.
  4. Search for Form and select it.
  5. Choose On-Page as the display method.
  6. Select the form you want to embed.
  7. Click Insert and save the page.

A button appears on the page; clicking it opens the form in a popup window:

  1. Follow steps 1–5 above, but choose Popup or Modal as the display method.
  2. Enter the button label (e.g., "Contact Us" or "Apply Now").
  3. Click Insert and save the page.

The popup approach keeps your page layout clean while still making the form easily accessible.

Form embed widget dialog

Embedding a Form on Another Website

You can show a form on a website that is not built with CMS Max, such as a landing page builder or a partner's site. The embedded form shows only the form, without your site's header, footer, or menus. Forms cannot be embedded until you allow it.

  1. Go to Forms and open the form you want to share.

  2. On the Settings tab, under Embed on other websites, turn on Allow other websites to embed this form.

  3. Click Save. The Iframe code appears below the toggle.

  4. Click the code to copy it, then paste it into the other website where the form should appear. It looks like this:

    <iframe src="https://yourdomain.com/embed/forms/2" title="Payment form" style="width: 100%; height: 900px; border: 0;"></iframe>
    
  5. Adjust the height so the whole form fits without a scroll bar inside it.

Good to know:

  • Payments from an embedded form go to your own payment gateway, the same one your site uses.
  • Redirect after submit: if the form sends visitors to a page after they submit, the embedded form shows a confirmation with a Continue button. The button opens your page in the visitor's browser window instead of inside the small embedded frame. If that page no longer exists, the confirmation shows without the button.
  • Pre-filling works here too. Add field identifiers to the embed address, for example https://yourdomain.com/embed/forms/2?amount=150. See Pre-Filling Form Fields via URL.
  • Tracking: the embed does not load your site's analytics or tracking scripts. Track visits on the website that hosts the embed.
  • Older browsers: a few older browsers (for example Safari on iOS 15) cannot finish a form inside another website. They see a message with a link that opens the form in a new tab.
  • Only the embed address can be shown inside another website. Your regular pages and your admin area still refuse to load inside another site's frame.
  • Turning the toggle off, or archiving the form, stops the embed. The other website then shows "This form is not available." A visitor who already had the form open sees the same message when they submit.

Pre-Filling Form Fields via URL

You can pre-populate form fields by adding information to the URL — useful for sharing links with specific information already filled in (for example, sending a customer a payment link with an amount pre-filled).

  1. Open the form editor and note the Identifier for each field you want to pre-fill.

  2. Add the identifier and value as a query parameter in the URL:

    yourdomain.com/contact?name=Sam

    This would pre-fill a field with the identifier name with the value "Sam".

  3. You can pre-fill multiple fields by chaining parameters with &:

    yourdomain.com/contact?name=Sam&email=sam@example.com

Address Autocomplete

If your form includes an address field with autocomplete enabled, visitors can start typing an address and select it from the Google Places suggestions. The form automatically populates all address components (street, city, state, ZIP code).

Note: This feature requires a Google Maps API key. Contact your site administrator if you need this enabled.

Phone Fields

Phone fields format US numbers automatically as visitors type — for example (585) 478-2331.

If your form needs to accept phone numbers from outside the US, enable the Allow international phone numbers toggle in the field's settings. The field then shows a searchable country dropdown with flags and dial codes, formats the number correctly for the selected country as the visitor types, and blocks invalid characters. Submitted numbers are stored in international format (for example +44 7400 123456), so you always know which country a number belongs to.

International phone field with country selector

Searchable country dropdown with flags and dial codes

When the toggle is off, required phone fields only accept valid US phone numbers.

Quantity Counter Fields

You can add a Quantity Counter field when you want visitors to increment/decrement numeric values instead of typing free-form text.

  • Single mode: one counter shown as [- number +]
  • Multiple mode: a list of counters with labels (for example: First, Second, Third)
  • Configuration: each counter supports an initial value, minimum, and maximum
  • Default behavior: minimum defaults to 0
  • Submission format: multiple values are stored as a single text value like First: 2, Second: 1 in exports/webhooks

Payment Fields

Each fee applies to one payment method. When your site takes both credit cards and ACH, choose it in the fee's Apply for column from the payment methods checked on the field. A new fee starts with the first payment method checked. If you uncheck a payment method a fee applies to, pick another one for that fee before saving. When you turn off one of the two payment gateways, its fees keep their payment method, so they are never charged to the other one, and the field warns you which fees aren't charged. If you save the form while that gateway is off, check its payment method again on the field after you turn the gateway back on.

When Show fee label to user is enabled, each fee appears on its own line, followed by the total on the last line. Labels appear on the left and amounts align by their decimal points on the right. Each payment method shows only the fees that apply to it. With fee labels hidden, visitors see only the total.

A payment field asks for a billing ZIP code and checks it before the card is charged:

  • The ZIP must match your site's primary country (Site Configuration → Primary Country; the United States unless you changed it). A US ZIP is 5 digits with no ZIP+4; a Canadian site takes postal codes such as K1A 0B1.
  • If your site allows more than one country (Site Configuration → Allowed Countries), visitors choose their country: in the address field's Country box, or in a Country select in the payment field when the form has no address field or its address field hides the Country box. The ZIP is checked against that country, and CardPointe and Authorize.Net are told the same country, so a Canadian card with a Canadian postal code goes through. A country you do not allow, or a misspelt one, keeps the primary country's rule. To take payments from another country, add it to Allowed Countries.
  • With Stripe, the payment field has no Country select and Stripe uses the country from its own card form. If the form has no address field Country box, the ZIP is accepted in the format of any of your allowed countries.
  • When the form has an address field, its ZIP code is used as the billing ZIP and any error appears under that field. This also applies to address fields that use Google address autocomplete.

The card gateway's own address check (AVS) only declines a ZIP the card issuer reports as a mismatch, so this check is what stops a mistyped or foreign ZIP from going through.

The confirmation email sent to the person who paid shows Payment Method: Credit Card (or ACH) instead of the payment gateway. The admin notification email and the submission page show the Payment Gateway, such as Stripe or CardPointe.

File Upload Fields

You can add file upload fields to any form, allowing visitors to attach documents, images, and other files to their submission.

Upload Limits

  • Maximum file size: 50MB per file
  • Multiple files: Forms can be configured to allow multiple uploads, each subject to the 50MB limit

Accepted File Types

Category Formats
Images JPG, PNG, GIF, WebP, SVG, AVIF
Videos MP4, MOV, AVI, MKV, WebM
Audio MP3, WAV, OGG, FLAC, AAC
Documents PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX
Text TXT, CSV, RTF
Archives ZIP

ZIP files follow the same 50MB per-file limit as every other accepted format. Visitors who select a larger file see a message naming the file and the limit, and that file is not uploaded. The Submit button stays disabled until every selected file finishes uploading. Include upload instructions in your form to help visitors prepare their files.

Uploaded files are securely stored in the cloud and accessible from the admin dashboard. A visitor can only submit files they uploaded themselves. If they leave the form open for a long time before submitting, the form asks them to upload the file again.

Form Templates

CMS Max provides ready-to-use templates for common form types to help you get started quickly.

Employment / Job Application Form

A standard application form with these fields:

  • Name (required)
  • Phone (required)
  • Email (required)
  • Resume upload (optional)
  • Additional information (required)

Online Bill Pay Form

Collect payments alongside contact information:

  • Full Name (required)
  • Phone (required)
  • Email (required)
  • Notes (optional)
  • Invoice Number (optional)
  • Payment Amount (required — supports credit card processing)

To use a template, navigate to your form builder and look for an Import option where you can load a template to get started.

Form editor

Spam Protection

Every form has a built-in spam trap that stops automated submissions:

  • The form is sent within a couple of seconds of appearing. The sender sees "Please wait a moment, then submit the form again." and nothing is saved. A visitor who was that quick, for example on a form already filled in from a link, just submits again. You can change the wait, or turn this check off, in Settings > Site Configuration > Security (see Form Spam Protection).
  • A hidden field is filled in. Visitors never see this field, but bots fill in every field. The sender sees the form's usual thank-you message or redirect, but nothing is saved, charged or emailed, so these submissions never reach your inbox.

Real visitors don't see the hidden field and fill in the form as usual.

The trap stops automated spam. For stronger bot protection, install the Cloudflare Turnstile plugin and turn on its captcha for the form. Neither one stops spam that a person types in by hand.

Viewing Form Submissions

All form submissions are stored in the admin panel:

  1. Navigate to Forms in the sidebar.
  2. Click on the form you want to review.
  3. Click the Submissions tab or button.

You can search submissions using any submitted field value, such as a person's name or email address. You can also view, export, and manage submissions from there.

Open a submission with a payment to find its Payment Gateway and Transaction ID in Payment Status. Use the ID to look up the original payment in that gateway. If the gateway reference is missing, the page shows Not recorded. For Paya ACH payments, the same panel also shows the settlement status.

An integration can also read submissions through the API, using a token from Settings > API (see API Access). Any API token on your site can read them, so revoke tokens you no longer use. The API is read-only: it lists submissions and returns a single submission with its submitted values and payment summary. Password fields are never included, deleted submissions are never returned, and links to uploaded files expire after an hour. Submissions of an archived form come back without file links, because those files can't be opened until the form is restored.

When you pick a form with a payment field in the Form filter, Payment Status cards appear above the list: All, which counts every submission of that form, then one card per payment status (Pending, Settled, Failed, Refunded, Partial Refund, Voided). The large number is that form's total; the "filtered" line under it counts only the submissions that match your other filters and search. Click a card to show only submissions with that payment status, or click All to show every status again. The selected card is outlined.

Form submissions view

Frequently Asked Questions

How do I get email notifications when someone submits a form?

Open the form editor and look for a Notifications or Email Alerts section. Add the email addresses that should receive notifications on each new submission.

Can visitors submit a form more than once?

Yes, by default. If you need to limit submissions per visitor, contact support for options.

Where are uploaded files stored?

Uploaded files are stored securely in CMS Max's cloud storage and are accessible through the form submission details in the admin panel.

How are uploaded filenames handled?

The original filename is preserved (lowercased, with spaces and special characters replaced by hyphens). For example, My Resume.pdf is stored as my-resume.pdf. If a visitor uploads a file with a name that already exists, an incrementing number is appended — my-resume-1.pdf, my-resume-2.pdf, and so on. In rare cases of heavy concurrent uploads, a short random suffix (e.g. my-resume-aB3.pdf) may be used instead. Existing files are never overwritten.

What happens if someone submits a file that is too large?

They will see an error message explaining that the file exceeds the size limit. Include a note in your form instructions advising visitors of the 50MB per file limit.