Skip to main content

Form Editor - Where Users Build & Connect Forms

The Form Editor in Intellectible allows you to build user-facing interfaces that interact seamlessly with workflows. Forms act as essential input sources where users provide data and as dynamic displays where workflow-generated results are presented. Mastering form creation, event handling, and workflow connections will help you build powerful, interactive automation solutions.

Interface Elements

Upon accessing the Form Editor, you'll interact with several primary interface components:

  1. Sidebar: Navigate back to the home screen and quickly access Intellectible's Home Dashboard, Flow Editor, Form Editor, and Settings.
  2. Form, Flow & Settings Selector: Quickly toggle between Flow Editor, Form Editor, and Workflow Settings to streamline your design and configuration process.
  3. Element Properties Panel: Adjust individual element properties such as labels, input validation, event handling, and visual styling.
  4. Element Hierarchy Panel: Visualizes the nested structure of elements on your form, facilitating organization and rearrangement.
  5. Pages Panel: Facilitates managing multiple pages within a single form, ideal for complex data collection and presentation.
  6. Element Add "+" Button: Allows the addition of new form elements onto the canvas swiftly.
  7. Form Canvas: Provides a visual workspace for designing, arranging, and previewing form elements.

Form Interface

Creating a New Form

  1. Navigate to the Form Editor in the top menu.
  2. Click "Create New Page" to start a blank form.
  3. Name your form clearly (e.g., “User Input Form”).
  4. Add elements to the form using the Element Add (+) button.

Common Form Elements & Components

The following is a complete list of available elements that can be added to forms using the Element Add (+) button. These elements allow for flexible layouts, interactive experiences, and both input and output handling. Use this reference to understand which element best suits your data collection or display needs.

Form Element List

Layout & Display Elements

ElementDescription
ContainerGroups other elements together and controls their alignment and spacing.
HeadingAdds a large heading to help users understand section titles.
ParagraphDisplays multi-line instructional or informational text.
MarkdownEnables you to add styled content using markdown syntax.
IFrameEmbeds another webpage or view into your form.
IconAdds visual icons (e.g. to indicate a step is completed or information).
ImageDisplays static image content such as a logo or reference graphic.

Input Field Elements

ElementDescription
Text LineBasic short single-line input.
Text AreaLarge, scrollable text input field for longer responses.
Long Text ListDropdown selector with a large data list (good for names, categories).
Chip ListSelect multiple items from a list – each shown as a “chip”.
Library PickerAllows selection of a document from the user’s document library.
Source PickerReferences linked or external sources like APIs or datasets.
CheckboxSimple toggle switch (yes/no or true/false).
File UploadUploads files like PDFs or images into the form.

Buttons & Navigation Elements

ElementDescription
ButtonGeneral-purpose button to trigger actions (e.g. submit, run AI).
Back ButtonNavigates to the previous form page. Useful in multipage flows.

Connecting Forms to Workflows

Connecting forms to workflows is what brings your forms to life. This connection allows user inputs to flow into automations and lets workflow outputs return directly to the form. Whether you're collecting a user's message, generating an AI response, or updating a document, this two-way link is essential to building dynamic, responsive user experiences.

To create these connections, you’ll rely on a few key practices:

1. Name Your Elements Clearly

Each element in your form (e.g., Text Area, Dropdown, Button) must have a unique name. This name is what workflows use to identify and interact with the element.

Example: A text input where a user enters their Ideal Job Role might be called target_job.

You can assign a name to an element by selecting it and editing the "Element Name" field in the Element Properties Panel.

Element Naming

2. Use the Names in the Flow Editor

When building your workflow, you can use Load Form Data and Set Form Data nodes to interact with form fields by name:

  • Use Load Form Data to retrieve user-entered values from the form.
  • Use Set Form Data to push processed values back into the form.

These nodes work by targeting the unique names assigned to each form element in the Element Properties Panel.

3. Trigger Workflows from Buttons

To trigger a workflow when a user clicks a button on a form, you’ll need to define a Form Event. This is done in two steps:

  1. Name the Button

    • Select the button in the Form Editor.

    • In the Element Properties Panel, set the event name field.

    • This name is what the workflow listens for.

    Example: A button with the text “Click Here to Analyse Your Resume” might have an event name of resume-analysis.

  2. Use a Form Event Node in the Workflow

    • In the Flow Editor, drag in a Form Event node.
    • Set the page (e.g., Homepage) and name to match the button’s event name (resume-analysis).
    • The node will fire whenever that button is clicked.

This allows your workflow to start dynamically based on user interactions.

Example: Clicking the “Analyse Resume” button triggers the workflow listening to the resume-analysis event on the Homepage page.

Button Click Event Button Settings

Testing & Iterating Forms

  1. Click "Run" in the Form Editor for a live preview.
  2. Input test data to validate form functionality.
  3. Verify workflow responses and adjust form layout and element settings as needed.
  4. Ensure buttons correctly trigger workflows and display outputs properly.

General Element Properties

The Element Properties Panel provides consistent styling and layout options applicable across most form elements. Customize visual appearance and structural behavior to enhance user experience.

Element Properties

Styling CategorySettingDescription
Container StylePaddingDefines spacing inside an element.
Flow DirectionOrganizes nested elements vertically or horizontally.
Item GapSpacing between nested elements.
JustificationAligns nested elements horizontally.
AlignmentAligns nested elements vertically.
OverflowManages content overflow within elements.
Visual StyleBackground ColorSets element background color.
Border StyleDefines the border appearance.
Border RadiusRounds border corners.
Border WidthThickness of borders.
Border ColorBorder color specification.
Width/HeightSets dimensions.
Min/Max Width & HeightConstrains dimensions within set limits.
Enable ShadowAdds shadow effect for depth.
Layout StyleMarginControls spacing around elements.
Self AlignmentPositions elements within containers.
GrowControls element expansion in available space.

Specific Element Properties

Individual elements may include additional specific settings. For example here is the Container element settings below:

  • Hyperlink Settings: Convert elements into links, define URLs, and link behavior.
  • Conditional Logic: Dynamically show or hide elements based on criteria.
  • Map List Data: Populate elements dynamically from workflow data.

Specific Element Settings

Element Hierarchy Panel

The Element Hierarchy Panel gives you a structured, tree-like view of all elements on your form, including how they're nested inside containers. This view is essential for:

  • Quickly locating and selecting deeply nested elements.
  • Understanding the structure and flow of your layout.
  • Reordering elements by dragging them within or across containers.
  • Cleaning up unused or duplicate elements.

This panel mirrors the structure on the canvas, making it easier to work on complex forms where elements may overlap or be hidden inside collapsible sections.

tip

Use the hierarchy to keep your layout clean and consistent—especially when using nested containers.

Element Heirarchy

Pages Panel

The Pages Panel helps you manage multi-page forms. Each page acts like a separate screen or section within your form.

From this panel, you can:

  • Add new pages using the “+ Add New Page” button.
  • Rename, reorder, or delete pages for better flow and clarity.
  • Switch between pages to edit different parts of your form.

Pages Panel

Deploying and Embedding Forms (Implementations)

An Implementation is a live, shareable version of a form in Intellectible. It acts like a public-facing tool or mini-application, allowing external users or collaborators to interact with a workflow without needing access to the Intellectible editor or dashboard.

Implementations are ideal when you want to:

  • Collect data or files from users outside your team
  • Let people interact with a form-driven workflow without granting editor access
  • Share a tool or service publicly while protecting the workflow logic
  • Deploy workflows safely, with version control and optional access restrictions

For more information

Best Practices for Form Design

  • Ensure intuitive and clearly labeled form layouts.
  • Apply conditional logic thoughtfully.
  • Conduct thorough testing with realistic scenarios.
  • Regularly update forms based on feedback and evolving workflow requirements.

By fully utilizing the Form Editor's features, you can build sophisticated, interactive forms that seamlessly enhance your workflows and user experiences within Intellectible.