Learn RunMacro from basics to advanced.

Everything you need to start and master RunMacro — from basic commands to advanced automation workflows.

Ctrl K

🧩 Smart HTML

Automate web elements by selector (Smart HTML)

What it does

The Smart HTML command acts directly on a web element (button, input, link...) using a recorded smart selector instead of coordinates. It re-resolves the element via multiple signals (id, text, attributes, even Shadow DOM), staying reliable when the UI shifts. It supports many actions: click/type/hover, extract text/attribute/table, check, select dropdown, wait and assert.

When to use it

Automate a website precisely by element (no coordinate drift).
Fill forms, click buttons, choose dropdowns on the web.
Extract data (text, links, tables) from a page.
Run in the background via Chrome/CDP without taking the real mouse.

Configuration steps

Use the element picker (Extension) to capture the target selector.
Add a Smart HTML command and choose the action (Click, Type, Extract...).
Choose the execution mode: Auto/CDP (background), Extension (active browser), or Real Mouse.
(For Type) enter content; (for Extract) set a result variable. Save.

Every option explained

Element selector (profile)

The element fingerprint captured by the picker. RunMacro re-resolves it at run time.

Action

Click / Double/Right Click / Hover / Type; Extract text, attribute, HTML, table, options; Check/Uncheck; Select dropdown; Wait and Assert.

Execution mode

Auto/CDP runs headless via Chrome; Extension acts on the open tab; Real Mouse uses the real cursor (click/double-click/right-click/type/hover only).

Text + submit

For the Type action: the content to enter; optionally press Enter to submit. Variables supported.

Attribute + result variable

For Extract: the attribute to read (e.g. href) and the variable to store the result.

Timeout (ms)

Max time to resolve/show the element before giving up.

Real example

Example: fill a web email field then click a button

Pick the email field selector, add Smart HTML action Type, enter the email.
Pick the "Continue" button selector, add Smart HTML action Click.
Use Auto/CDP mode to run in the background.

Tips & common mistakes

Smart HTML is more accurate than coordinate-based Mouse Click on the web — prefer it for Chrome.

Wait/Assert/Extract actions need CDP or Extension mode (Real Mouse is click/double-click/right-click/type/hover only).