Public Forms Documentation

Public Form Layouts

A Public Form Layout lets you define custom HTML that wraps the form fields rendered for a public form action. Instead of the default bare form, you can design a fully branded page — with headers, logos, and styling — while the form fields are injected automatically via the <FormFields /> placeholder.

Layouts are managed from the editor under Public Form Layouts. To create one, open the drive and create a new Public Form Layout file.

Once created, link it to an action via the publicformlayoutuuid field in the action's public_form meta:

        
"action_meta": {
  "public_form": {
    "enable": true,
    "publicformlayoutuuid": "your-layout-uuid"
  }
}


      

The layout has two environments — draft and live — allowing you to iterate on the design and publish when ready.

# Variables

You can pass variables into the layout via public_form_variables in the action meta. These are interpolated into the layout HTML using {{public_form_variables.key}} syntax.

        
"action_meta": {
  "public_form": {
    "enable": true,
    "publicformlayoutuuid": "your-layout-uuid",
    "public_form_variables": {
      "heading": "Dealer Onboarding Form {{stub.stubref}}",
      "description": "Welcome to Jenny's dealer network! Please fill out the form below to get started"
    }
  }
}


      

In your layout HTML, reference them like this:

        <h1>{{public_form_variables.heading}}</h1>
<p>{{public_form_variables.description}}</p>

      

Variable values themselves support Stubber interpolation, so you can embed dynamic values like {{stub.stubref}} directly inside them.