AgenCMS

Forms

Forms let you collect information from visitors, from a simple contact form to a multi-field application. You build a form once in the drag-and-drop builder, embed it on a page, and review every response in one place.

Open the Forms area

  1. Go to your website workspace.
  2. In the sidebar, open Forms (/dashboard/websites/{website}/forms).
  3. The page lists every form as a card showing its status, slug, and submission count.

Each card has a menu (the dots icon) with Submissions, Preview, Builder, Duplicate, and Delete.

To start a new form, click New form (or Create your first form if the list is empty).

Build a form

The builder has three areas: the field palette on the left, the canvas in the middle, and the settings panel on the right.

  1. Drag a field type from the palette onto the canvas.
  2. Drag fields up or down to reorder them, or drop a new field between two existing ones.
  3. Click a field on the canvas to edit it in the settings panel.
  4. To remove a selected field, press Delete or Backspace.

Available field types:

  • Text Field, Textarea, Email Field – free-text inputs.
  • Select Dropdown, Checkboxes – choice inputs.
  • File Upload – let visitors attach a file.
  • Heading, Divider – layout helpers.
  • Hidden Field – capture a value without showing it.

Field settings and validation

Select any input field to set its Label, Name, Placeholder, and Help Text. Turn on Required to make the field mandatory, and set Width to lay fields out side by side (for example two fields at 50%).

Text fields also support Min Length and Max Length. For File Upload, set Accepted File Types (such as .pdf,.doc,.jpg) and Max File Size (MB). For security, executable and script file types are always blocked even if you list them.

Form settings and handlers

Click an empty part of the canvas to deselect fields and reveal the Settings and Handlers tabs.

Under Settings you can edit the Form Name, Slug, and Description, plus submission options: Success Message, Submit Button Text, Button Alignment, and Honeypot Protection (a spam guard that is on by default).

Under Handlers you choose what happens after a submission. Toggle on any of:

  • Send Email – notify one or more addresses, with a custom subject.
  • Redirect – send the visitor to a URL.
  • Download File – offer a file to download.
  • Webhook – POST the submission to an external URL.

Save and publish

The builder saves your changes as a draft automatically; the toolbar shows Saving... or Unsaved changes while it works. A form does not accept submissions until it is live.

  1. Click Publish (or Publish changes if it is already live) in the toolbar.
  2. A green Live badge appears once the published version is serving.

To take a form offline, open the more menu and choose Unpublish. You can roll back through Revisions in the toolbar. Use Preview at any time to test the form without affecting the live site.

Embed a form on a page

Forms appear on your site through the Form section.

  1. Open a page in the page builder.
  2. Add the Form section and pick a layout (centered, split, full-bleed, or editorial).
  3. In the section settings, use the Form picker to choose which form to render inline.
  4. Optionally set a Submit button text override, Decorative image, and headline copy.

Only published forms collect responses, so publish the form before relying on it in production.

Review submissions

From the Forms list, open Submissions on a form card (or View submissions) to see every response at /dashboard/websites/{website}/forms/{form}/submissions. Click a row to see the full submission, including any uploaded files. You can delete individual submissions you no longer need.

Storage quota

Uploaded files count against your plan's storage allowance. The free default is 1 GB; paid plans include unlimited storage. If you collect a lot of large attachments, delete old submissions to free space, or upgrade your plan. See Plans & billing for the limits on your tier.