Page Action Nodes

Page Action nodes control browser tabs, open webpages, and interact with page elements. This guide covers all 17 RPA Plus Page Action nodes.

Element nodes generally use a selector or saved element object. See Select a Location Method and Select a Matching Element.

Page Action nodes

Tab Nodes

New Tab

Opens a new tab in the active browser profile without business configuration. Subsequent page actions run in the new tab.

Close Tab

Closes the active tab. Before closing, confirm that downstream nodes do not need variables or element objects from the page.

Close Other Tabs

Keeps the active tab and closes other tabs in the same profile. Use it near workflow start to remove stale pages before subsequent tab switches.

Switch Tab

Finds and activates a target page by title or URL.

For a page whose URL contains /download, select URL, Contains, and enter /download.

Continue with clicks or data reads after switching. If several tabs match, narrow the rule until it identifies one page.

Switch Tab configuration

No.	Setting	Values or description
1	Match field	Title or URL
2	Match method	Equal, Not Equal, Contains, or Does Not Contain
3	Match value	Title or URL to find; variables are supported

Target tab after switching

Page Navigation Nodes

Access Website

Opens a URL. The URL field supports variables and has a default timeout of 10000ms.

Replace this example with the URL used by your workflow
https://example.com/search?q=${keyword}

• Include a scheme such as https://.
• Increase the timeout for a slow response and use Wait for Element or Wait for Request afterward to confirm that content is ready.

Refresh Page

Reloads the active tab with a default timeout of 10000ms. Refreshing changes the DOM and can invalidate saved element objects. Locate elements again after refreshing.

Forward

Moves forward one page in browser history with a default timeout of 10000ms. If there is no forward entry, the tab does not navigate.

Back

Moves back one page in browser history with a default timeout of 10000ms. Wait for key elements again after navigating back.

Screenshot

Saves the current page as an image. Configure:

• File name.
• Default or selected local directory.
• Full page or visible area.
• Image format: png, jpeg, or webp.
• Timeout.

The defaults are full page, png, and 10000ms.

Include task or profile information in the file name to distinguish results:

product_${serial_number}_${task_id}

Selecting a local directory and writing a screenshot requires the ZYBrowser desktop client and local file permission.

Screenshot node configuration

Screenshot result

Element Interaction Nodes

Hover Element

Moves the pointer over a target element to trigger a hover menu, tooltip, or delayed content. Use a selector or saved element object.

When hover content needs time to appear, add Wait for Element afterward instead of relying only on a fixed delay.

Select Dropdown

Locates a dropdown and selects a value. Use a selector or saved element object.

The value must match the option value used by the page. When visible text differs from the underlying value, inspect the page structure or validate with debugging.

Focus Element

Focuses a target element. Use it before a key or shortcut, or select a saved element object.

Click Element

Supports:

• Mouse button: Left, middle, or right.
• Click count: Single or double.
• Mouse mode: X/Y coordinates and release delay.
• Element source: Generic location or saved element object.

Left single-click is the normal business action. Right-click opens the page context menu; middle-click can invoke browser-specific behavior. Debug the result after either.

Mouse mode is useful when X/Y and release delay are required, but zoom or layout changes can affect it. Prefer a standard element click when the element can be located directly.

Click Element configuration

Enter Text

Enters text into a target input. Configure:

• Selector or saved element object.
• Variable-enabled input.
• Whether to clear existing content first.
• Character interval, default 300ms.

For login and search, clear first to avoid concatenating with a prefilled value. Preserve or increase the interval for pages that are sensitive to input speed.

Enter Text configuration

Sensitive Information

Never write the real value of sensitive variables such as account_password in notes, screenshots, or public logs.

Run JavaScript

Runs JavaScript in the page context. Enter the script in the code editor, select variables to inject, and save the return value to an output variable.

1. Select the system or workflow variables required by the script.
2. Write the script and define its return value.
3. Enter an output variable name when downstream nodes need the result.
4. Save the node and debug it.

The editor validates JavaScript syntax and the output variable name. Select only variables the script needs to reduce maintenance and avoid exposing unrelated sensitive data to the script context.

Example: return the current page title.

return document.title;

The script depends directly on the page DOM and runtime environment. Validate it again after a page upgrade and do not use it to bypass a stable standard node operation.

Run JavaScript configuration

Scroll Page

Scroll the complete page or a selected element.

Setting	Description
Scroll target	Complete page or an element located by selector
Target position	Top, middle, bottom, or a pixel position
Scroll mode	Smooth or immediate
Distance per step	Range for each scroll
Pause	Range between scrolls

For an infinite list, combine stepped scrolling and pauses with Wait for Element or data collection to confirm that new content has loaded.

Scroll configuration

Upload Attachment

Upload Attachment locates a webpage file input and selects a source:

Source	Description
Local file	Uploads one specified local file
Random file from folder	Selects one file randomly from a directory
Network URL	Fetches a file from a URL at runtime

The default timeout is 30000ms. Locate the input with a selector or saved element object.

Before running, confirm that:

• The local path exists and is readable on the task computer.
• The folder contains only permitted file types.
• The network URL is reachable and points to an actual file.
• The page file input matches the location rule.

Selecting local files and folders requires the desktop client. Update paths after migrating a workflow to another computer.

Upload Attachment configuration

Common Combinations

Open a Page and Submit a Form

Access Website → Wait for Element → Enter Text → Click Element → Wait for Request

Open a New Tab and Return to the Results

New Tab → Access Website → Actions → Switch Tab

Scroll and Read Lazy-loaded Content

Scroll Page → Wait for Element → Get Element Data

Related Guides

• Element Location and Selectors: Select CSS selectors, XPath, text, or element objects.
• Keyboard and Wait Nodes: Send keys and wait for page state.
• Data Collection and Storage Nodes: Read page, cookie, and file data.
• Debug Automation Workflows: Validate page actions and review node logs.