Set checkbox

Set a checkbox to a target state, clicking only when the current state differs. Legacy step, prefer Click on modern checkboxes.

Deprecated. This step no longer appears in the step palette. Existing tests that use it keep running. For new tests, use Click on the checkbox. A click toggles the state instead of setting it, so verify the result with Verify element when it matters.

Set a checkbox to a target state. The step only clicks when the current state differs from the requested one, so it is safe to repeat.

Parameters

ParameterRequiredDescription
Target elementYes, unless a manual selector is setNatural-language description of the checkbox.
Manual selectorNoXPath or CSS selector, used when AI is disabled or as the saved selector.
Set as checkedNoThe target state. Default: off (unchecked).
AI usageNoinherit (default, follows the test strategy), smart, or always.
Ignore error on this stepNoThe run continues with the next step if this one fails. Default: off.

Results and metrics

  • Timing: start, end, and duration (in seconds) recorded in the step result.
  • Status: success, warning, or failed, with the error message on failure.
  • Screenshot: captured after the step runs.

What's next?

Click

The current way to toggle checkboxes

Verify element

Confirm the checkbox ended up in the right state

Last updated on