All docs
Feature reference Build tests 2 min reference

Element picker

The element picker lets you click an element on the live page so Rima can capture its selector and readable properties for a validation.

This reference explains the term, its purpose, a practical example, common use cases, where it appears in Rima, and the closest product visual.
Adding a validation in the Rima extension
Validations define the result that must be true for a test to pass.

Definition

The element picker lets you click an element on the live page so Rima can capture its selector and readable properties for a validation.

What it is for

It avoids manually inspecting HTML or writing a selector for the element you want to check.

How it works

  • Start the picker, hover the page to preview candidate elements, then click one to lock it.
  • The picked summary shows the tag, a selector chain, ID, classes, and text; in Advanced mode the selector field is filled in for you.
  • Use Refresh Picked to reload details from the tab, then add the validation when the target looks right.
  • The picker can build selectors that pierce shadow DOM boundaries.

Example

Click “Pick element”, select the cart badge, and validate that its text equals 1.

Common use cases

  • Target a status badge.
  • Validate a form field.
  • Check a checkbox.
  • Capture a stable selector for a button or message.

Where to find it

Use Pick element in the validation editor while the target page is open in the active tab.

Limitations, requirements, and permissions

  • Needs the target page open in the active tab; the picker stops when the side panel hides or closes.
  • Picking an element does not add a validation by itself; you still press Add Validation.
  • Complex shadow DOM structures may still need manual selector editing.

Related features and guides

Ready to try it yourself?

Create your free account, record your first flow, add a validation, and let Rima run it on a schedule for you.

Start free trial