> ## Documentation Index
> Fetch the complete documentation index at: https://docs.digifist.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Contact Form

> Customizable contact form with flexible field types and customer data binding.

The Contact Form template (form-contact) provides a fully customizable contact form with support for various field types, customer data binding, and flexible layout options.

<img src="https://mintcdn.com/digifist/dgUL6t3SIKQyfdCS/images/theme/release/sections/form-contact/form-overview.png?fit=max&auto=format&n=dgUL6t3SIKQyfdCS&q=85&s=5b9adc6b5792d515131f0773e021cd0b" alt="Contact form overview" width="3280" height="2186" data-path="images/theme/release/sections/form-contact/form-overview.png" />

## What this section controls

* Customizable form fields (text, email, tel, checkbox, radio)
* Field layout and column spanning
* Customer data binding for logged-in users
* Required field validation
* Form submission and success messaging

## Section settings

<Tabs>
  <Tab title="Layout">
    ### Section width

    Control the maximum width of the contact form.

    **Available options:**

    * **max-w-page** - Standard container
    * **max-w-narrower** - Narrow focused layout
    * **max-w-fluid** - Wider container

    **Default:** max-w-narrower

    <Tip>
      Narrower width improves form readability and completion rates by reducing visual noise.
    </Tip>

    ### Color scheme

    Select the color scheme for the form section.

    * **Default:** scheme-1

    ### Spacing top & bottom

    Adjust padding above and below the form.

    **Options:** No (0), S (1), M (2), L (4), XL (6)

    * **Default:** M (2) for both

    <img src="https://mintcdn.com/digifist/yuggJPUIy_CDeMJf/images/theme/release/sections/form-contact/layout-settings.png?fit=max&auto=format&n=yuggJPUIy_CDeMJf&q=85&s=0a856901099d53ce97c55a7e86561a83" alt="Form layout settings" width="3280" height="2186" data-path="images/theme/release/sections/form-contact/layout-settings.png" />
  </Tab>
</Tabs>

## Block settings

### Field Block

Add customizable form fields to build your contact form. Each field can span full or half width.

<Tabs>
  <Tab title="Basic Settings">
    ### Column factor

    Control the width of the field.

    **Available options:**

    * **Full width** (6) - Spans entire form width
    * **Half width** (3) - Takes up half the row

    **Default:** Full width

    ### Heading (Label)

    The label text displayed above the field.

    * **Default:** "Label"
    * This will be used to generate the field name

    ### Type

    Choose the field input type.

    **Input fields:**

    * **Text** - Single line text input
    * **Email** - Email address input
    * **Tel** - Telephone number input

    **Selection fields:**

    * **Checkbox** - Multiple choice checkboxes
    * **Radio** - Single choice radio buttons

    **Default:** Text

    ### Required

    Mark the field as required for form submission.

    * **Default:** Disabled

    <img src="https://mintcdn.com/digifist/yuggJPUIy_CDeMJf/images/theme/release/sections/form-contact/field-basic.png?fit=max&auto=format&n=yuggJPUIy_CDeMJf&q=85&s=2b7fa481dd1a2c7596284ec173913246" alt="Basic field settings" width="3280" height="2186" data-path="images/theme/release/sections/form-contact/field-basic.png" />
  </Tab>

  <Tab title="Input Fields">
    Available for Text, Email, and Tel field types.

    ### Placeholder

    Placeholder text shown when field is empty.

    * Optional hint text for users

    ### Binding

    Bind field to customer data for logged-in users.

    **Available options:**

    * **Custom** - No binding
    * **Email** - Customer email
    * **Name** - Full name
    * **First name** - First name only
    * **Last name** - Last name only
    * **ID** - Customer ID
    * **Phone** - Phone number
    * **Last order** - Last order number

    **Default:** Custom

    <Tip>
      Use email binding for email fields to auto-fill for logged-in customers, improving form completion rates.
    </Tip>

    <img src="https://mintcdn.com/digifist/yuggJPUIy_CDeMJf/images/theme/release/sections/form-contact/input-fields.png?fit=max&auto=format&n=yuggJPUIy_CDeMJf&q=85&s=365e5882eb5a69bae8ca20932dc522fb" alt="Input field settings" width="3280" height="2186" data-path="images/theme/release/sections/form-contact/input-fields.png" />
  </Tab>

  <Tab title="Selection Fields">
    Available for Checkbox and Radio field types.

    ### Checked

    Set default checked state for checkbox/radio.

    * **Default:** Unchecked

    ### Label description

    Additional descriptive text for the selection field.

    ### Options 1-4

    Define up to 4 options for checkbox or radio selection.

    * Each option creates a selectable choice
    * Leave blank to hide option

    <Note>
      Checkbox fields allow multiple selections, while radio fields allow only one selection.
    </Note>

    <img src="https://mintcdn.com/digifist/yuggJPUIy_CDeMJf/images/theme/release/sections/form-contact/selection-fields.png?fit=max&auto=format&n=yuggJPUIy_CDeMJf&q=85&s=30d555332c404fc3df8546cca999e814" alt="Selection field options" width="3280" height="2186" data-path="images/theme/release/sections/form-contact/selection-fields.png" />
  </Tab>
</Tabs>

## Best practices

* **Form width:** Use max-w-narrower (default) for better readability and completion
* **Required fields:** Mark name, email, and message as required minimum
* **Half-width fields:** Use for related pairs (first name/last name, city/zip)
* **Full-width fields:** Use for message/textarea and single important fields
* **Email binding:** Always bind email field to customer email for convenience
* **Field order:** Name → Email → Subject/Reason → Message is standard flow
* **Placeholder text:** Use to provide format hints ("[john@example.com](mailto:john@example.com)", "+1 (555) 123-4567")
* **Checkbox for consent:** Add required checkbox for terms/privacy acceptance
* **Radio for categories:** Use for predefined options (inquiry type, department)
* **Keep it short:** 4-6 fields maximum for higher completion rates

## Common use cases

* **Basic contact** - Name (text, required), Email (email, required, binding: email), Message (text, full-width, required)
* **Support inquiry** - Name, Email (binding: email), Order ID (text, binding: last\_order), Issue type (radio: Technical/Billing/General), Description
* **Newsletter signup** - Email (email, required, binding: email), Consent checkbox (required, "I agree to receive newsletters")
* **Quote request** - First name + Last name (half-width), Email, Phone (tel, binding: phone), Service type (checkbox), Budget range (radio), Details
* **Partnership inquiry** - Company name, Contact name, Email, Phone, Partnership type (radio), Message
* **Product inquiry** - Name, Email, Product interest (radio), Quantity needed, Additional information

## Related guides

<Card title="Newsletter Popup" icon="envelope" href="/themes/release/sections/newsletter-popup">
  Configure newsletter signup popup
</Card>

<Card title="Page Settings" icon="file" href="/themes/release/page">
  Create custom pages for forms
</Card>
