Get Forms Schema

Describe the forms on the active tab: every field, its label, type, current value, rules and choices.

What it does

Get Forms Schema returns one item per form, each with the form’s details and a fields list.

Which forms it reads:

• DOM Selector empty: every form on the page.
• DOM Selector set: the selected element if it is a form, any forms inside it, and the form that contains it. So you can point at a single field and still get its whole form.

For each field you get its label (from the field’s label, or its accessibility label), name, id, type (text, email, checkbox, select, textarea…), a selector to target it, and whether it is required, disabled or read-only. You also get its current value and, when the page sets them, limits such as min, max, maxLength and pattern. Drop-down lists include their options, each with a label and a value.

The node only reads: it does not change or submit anything.

When to use it

• Before Form Fill: find the id or name of each field you need to fill.
• Give an AI node the list of fields so it knows what a form asks for.
• Check which fields are required, or which choices a drop-down offers.

Inputs and settings

Setting	Type	What it does
DOM Selector	Page element	The selector of the DOM element to interact with.

To read one form, click the crosshair button in DOM Selector and click any field of that form. Leave it empty to read all forms.

Outputs

• Output

Each run returns a list of items with these fields:

Field	Type	What it holds
id	Text
name	Text
selector	Text
action	Text
method	Text
enctype	Text
target	Text
autocomplete	Text
noValidate	True/false
fieldCount	Number
fields	List of entries

Shape of an output item

[
  {
    "id": "…",
    "name": "…",
    "selector": "…",
    "action": "…",
    "method": "…",
    "enctype": "…",
    "target": "…",
    "autocomplete": "…",
    "noValidate": true,
    "fieldCount": 0,
    "fields": []
  }
]

• action and method: where and how the form sends its data (for example https://example.com/signup, post).
• fieldCount: how many fields the form has.
• fields: the field list described above. Read one with an expression such as {{ $input.fields[0].label }}.

Dependencies and credentials

None. This node needs no connection and has no slots for other nodes.

Example workflow

1. Open a sign-up page and run the workflow from a Hotkey trigger.
2. Add Get Forms Schema with DOM Selector set to the email field.
3. Run it once and look at the output: note the name or id of each field, for example email and full_name.
4. Add Form Fill in Manual mode with two Values entries: Field ID email / Value jane@example.com, and Field ID full_name / Value Jane Doe.

Common issues

• “No forms found”. The page has no form element, or none matches DOM Selector. Some sites build forms from plain boxes without a real form; for those, use Get Accessibility Tree to find the fields.
• A field has an empty label. The page does not label it. Use its name, placeholder or id to recognize it.
• The form loads after the page. Add Wait For Element for one of its fields first.
• The node fails outside the extension. This node runs in the browser extension; install it or run the workflow from the extension.

Related nodes

• Form Fill: fill the fields you found.
• Submit Form: send the form.
• Get Accessibility Tree: all controls, including ones outside forms.