Form Container

A container widget that wraps form input fields and handles submission. All form widgets (Text Input, Select, File Upload, etc.) must be placed inside a Form Container to participate in form submission.

Properties

Property	Type	Default	Description
action	text	''	The action slug to execute on submission. Leave empty to use an inline onSubmit action.
method	select	'POST'	HTTP method: POST or GET.
successMessage	text	'Submitted successfully.'	The message displayed to the user after successful submission.
notifyEmail	text	''	Email address to notify on form submission. Leave empty for no notification.

Events

• onSubmit -- Fires when the form is submitted. All child form field values are passed as the action's input data.

Container

This widget is a container -- drag form input widgets and a Submit Button inside it.

Example

A contact form:

action: handle_contact
method: POST
successMessage: Thank you! We'll be in touch.
notifyEmail: admin@example.com

Inside the Form Container:

• Text Input -- name: full_name, label: Your Name, required: true
• Text Input -- name: email, label: Email, required: true
• Textarea -- name: message, label: Message, required: true
• Submit Button -- label: Send Message

Tips

• Every form input widget inside the Form Container contributes its name: value pair to the submitted data.
• The action property references a reusable action by slug. Alternatively, attach an inline pipeline via the onSubmit event in the Events tab.
• The successMessage is displayed as a success alert after the action completes without errors.
• The notifyEmail sends a simple email notification with the form data. For custom email templates, use the Send Email node inside your action pipeline instead.
• Nest layout widgets (Containers, Cards) inside the Form Container for complex form layouts -- only form input widgets contribute values.
• Always pair with server-side Validate and Sanitize nodes in your action.