Element Picker
The Element Picker is the primary way to select elements on a web page for automation.
How to Use
Section titled “How to Use”- In the Visual Builder, click the pointer icon next to any selector field.
- Your cursor changes to a crosshair.
- Move your mouse over the page. Elements are highlighted with a red overlay.
- Click an element to select it.
- A refinement panel appears.

Refinement Panel
Section titled “Refinement Panel”After clicking an element, you see:
| Button | Description |
|---|---|
| ✓ (Confirm) | Accept the current selection and generate the selector |
| ✗ (Exclude) | Exclude this element and refine the selection |

Excluding Elements
Section titled “Excluding Elements”If the initial selection includes elements you don’t want:
- Click ✗ on the unwanted element.
- The element is excluded from the selection.
- The selector is refined automatically.
- Repeat until only the desired elements are selected.
- Click ✓ to confirm.
Selector Generation
Section titled “Selector Generation”The element picker generates the most appropriate selector type:
- CSS selector for elements with stable classes or IDs
- XPath for complex nested structures
- Text selector for elements identified by their text content
Text Selection
Section titled “Text Selection”You can also select text directly:
- Click the pointer icon.
- Highlight text on the page.
- The selected text becomes a
text=selector.
| Tip | Description |
|---|---|
| Click precisely | Click the exact element you want, not a parent container |
| Use exclusion | If too many elements are selected, use ✗ to exclude unwanted ones |
| Check the generated selector | Verify the selector in the field after selection |
| Use data attributes | Elements with data-id or data-product-id make stable selectors |
| Avoid auto-generated classes | Classes like .css-1a2b3c change frequently |