Browse the docs

A form is submitted

Runs the macro when a form on a page is submitted, with its fields.

A form is submitted

Details #

Fires when a form is submitted. selector limits it to one form. The run starts with the page's inputs plus action, method and fields: a dictionary of the form's values.

Password, hidden and file fields are left out, always.

Parameters #

ParameterTypeRequiredValuesWhat it does
matchrecordbrowser title urlWhich pages. url is a pattern (https://*.github.com/*/pull/*), a plain start (github.com/apple) or /regex/; title is text (any case) or /regex/; browser is safari, chrome or any.
selectortextOnly this form. Any form when left out.

Every trigger also takes Limits: a cooldown, the first time each day, every nth time, twice within seconds, a chance, only while you are at the Mac, on one Mac, or in a State. See Limits on any trigger.

Examples #

Log every search
When
  1. A form is submitted on a page on www.example.com/*
Do
  1. Log “Searched: {{fields.q}}”
Open in Switchboard to try it

Gotchas #

  • Field values are kept in the run's trace under the same redaction rules as webhook bodies.