Set checkbox

Legacy step that checks or unchecks a checkbox. Use Click in a web test instead.

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 checked or unchecked. The step only clicks when the box is not already in that state, so running it twice does not undo the first run.

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