TDCSites
DashboardForms

Creating Forms

Build forms with any field types, embed them in your site, and configure submission behavior.

Forms let you collect structured data from visitors — contact requests, sign-ups, surveys, orders, and more. Each form is built visually and can be embedded anywhere in your site using a Form block in the Visual Page Editor.

To get started, navigate to your site dashboard and click the Forms tab.


Creating a Form

  1. Click New Form in the top right.
  2. Enter a Form Name (used internally — not shown to visitors).
  3. Click Create Form.

You will be redirected automatically to the form detail page.


Form Detail Page

The form detail page contains three primary management tabs in the left sidebar (on desktop) or top dropdown menu (on mobile): Fields, Submissions, and Settings.

Fields Tab

This is where you build your form by adding and configuring inputs.

Screenshot placeholder

Form fields editor

Adding or Editing a Field

  1. Click + Add field at the bottom of the list.
  2. Configure the field properties (see below).
  3. Click Save field.
  4. To edit an existing field, click the Edit button next to its row. To delete a field, click Del.

Field Types

Select from the following input types:

TypeDescription
TextSingle-line text input
EmailEmail address input
PhoneTelephone number input
NumberNumeric input (integers or decimals)
TextareaMulti-line text block
DropdownDropdown select menu with predefined options
CheckboxSingle on/off checkbox toggle
RadioSingle-choice radio button list
DateCalendar date picker
File uploadVisitor file attachment uploader
HiddenHidden field to pass prefilled metadata invisible to users

Field Properties

For each field, you can set the following properties:

PropertyDescription
LabelThe display name shown to visitors above the input field.
Field name (key)The unique database key for the field (e.g. full_name). This is auto-synced from the label but can be customized manually.
RequiredA toggle switch to mandate input before the form can be submitted.
WidthChoose between Full (100% width) or Half (50% width) to arrange fields side-by-side.
PlaceholderHint text shown inside the input (available for Text, Email, Phone, Number, and Textarea).
Default valuePre-filled initial value (available for Text, Email, Phone, Number, and Textarea).
OptionsDefine option choices (Label and Value pairs) for Dropdown and Radio fields.
Validation RulesApply input constraints based on field type:
Text, Textarea, Phone: Set Min length, Max length, and Regex Pattern (for custom validation matches).
Number: Set Min value, Max value, Min length, and Max length.

Reordering Fields

Use the Up (▲) and Down (▼) arrow buttons on the far left of each field row to reorder the fields in the list.


Embedding a Form in Your Site

Once your form is configured, embed it in any page using a Form block in the Visual Page Editor:

  1. Open the editor for your page.
  2. Locate or insert a section that contains a Form block.
  3. Select the form block. In the right-hand sidebar under the Content tab:
    • Select form: Choose your form from the dropdown of existing forms. (You can also click + Create new form here to build a new form inline).
    • Edit form fields & settings: Click this button to open the full Form Editor drawer inside the page editor so you can make quick changes without leaving the page.
    • Column layout: Choose between 1 Column or 2 Columns layout structure.
    • Show labels: Toggle field labels visibility On or Off.
    • Field gap (px): Specify spacing (0–64px) between fields.
    • Button alignment: Align the submit button to Left, Center, Right, or Full width.
  4. Switch to the Styles tab in the sidebar to customize the background (Solid or Gradient), text color, input fields theme, button styles, borders, padding, and drop-shadows.

Submissions Tab

The Submissions tab displays all submitted visitor data in a clean data table.

  • Columns: Displays Date (local date & time), Status, value columns corresponding to each form field, and IP Address.
  • Pagination: View submissions in chunks of 10, 20, 50, or 100 entries per page.
  • Export CSV: Click Export CSV in the top right to download all submissions in a .csv file. The exporter paginates through all your records to package a clean download.

Form Settings Tab

Adjust the behavior, spam protection, and status of the form under the Settings tab:

Identity

  • Form Name: The internal display name of the form.
  • Slug: URL-safe identifier for the public submit endpoint (validated to be lowercase alphanumeric + hyphens only).

Submission

  • Submit button label: Custom text on the submit button (e.g., "Send Message").
  • Success message: Message shown on-screen after a successful submission.
  • Redirect URL (optional): If specified, visitors are redirected to this URL upon successful submission instead of seeing the success message.

Protection

  • Honeypot spam trap: An invisible form field designed to catch spam bots automatically. (Recommended to keep Enabled).
  • Google reCAPTCHA v2: Enable to require human verification checkbox validation.
  • Limit one per email: Restrict submissions to only one entry per email address.

Status

  • Accept new submissions: Toggle switch to make the form active or inactive. When inactive, the form will refuse new entries.