Skip to main content Skip to docs navigation
View on GitHub

Action

What an action is and how to configure its key properties.

On this page
Element Finder Locate the target element on the page using flexible strategies.
Value Define what the action does—click, fill, or trigger events.
Addon Extend actions with additional features or integrations.
Action Settings Fine-tune advanced options and error handling for actions.
Action Condition Add logic to run actions only when certain conditions are met.

An action combines an element finder and a value.

  • Element finder: locates the target element on the page (multiple strategies supported).
  • Value: defines what to do—leave blank to click, or supply text/commands/events. See the action value guide for all options.

New: You can also add a Userscript as a full action using the “Add Userscript” button next to Add Action. Enable the Userscript switch on the extension’s details page before using it. Userscripts can replace the Name, Init Wait, Repeat, and Repeat Interval fields with custom logic and run alongside other actions.

If the element isn’t found, the extension retries per your configuration (global or action‑level) and then follows your error handling choice. See Retry, Settings, and Action settings for Stop, Skip Action, Refresh, or Goto Action.

Init Wait

Delay the start of this action by a given number of seconds. Useful when the page needs a little extra time to become ready.

Details:

  • Runs only the first time the action executes (not on repeats in a loop).
  • Value is in seconds and supports decimals and ranges (for example, 1.5, 1e4).
  • Optional: if left blank, the action starts immediately.

Examples (seconds)

  • 0.5 — half a second
  • 1 — one second
  • 1.5 — one and a half seconds
  • 2 — two seconds
  • 1e4 — random value between 1 and 4 (custom range syntax)
  • 2e5 — random value between 2 and 5 (custom range syntax)
  • 0.5e1.5 — random value between 0.5 and 1.5 (custom range syntax)
  • Leave blank to use the default value (or start immediately, depending on the field)

Note: The aeb format above is not scientific notation. It indicates a random number in the inclusive range [a, b] and supports decimals.

Name

A label to identify the action in your list. Optional—use any name that helps you recognize its purpose.

Repeat

Run this action additional times after the first run. By default, an action runs once.

Details:

  • Repeat = 0 or blank → run once.
  • Repeat = 1 → run twice (1 extra time), and so on.
  • Accepts positive integers 1 to 999.

Repeat Interval

Time to wait between each repeat of this action (in seconds). Supports decimals and the aeb range syntax for random delays.

Examples (seconds)

  • 0.5 — half a second
  • 1 — one second
  • 1.5 — one and a half seconds
  • 2 — two seconds
  • 1e4 — random value between 1 and 4 (custom range syntax)
  • 2e5 — random value between 2 and 5 (custom range syntax)
  • 0.5e1.5 — random value between 0.5 and 1.5 (custom range syntax)
  • Leave blank to use the default value (or start immediately, depending on the field)

Note: The aeb format above is not scientific notation. It indicates a random number in the inclusive range [a, b] and supports decimals.

Disable

Temporarily turn off an action. Disabled actions are skipped during execution.