Skip to main content
Before using Airtop browser automation tool steps, you need to configure the Airtop integration. See the Airtop integration setup guide for instructions on connecting your Airtop account.
The Airtop Page Interaction tool steps allow you to interact with web page elements, including clicking buttons, typing text, and scrolling through pages.

​
Add the ‘Airtop - Click Element’ Tool step

You can add the ‘Airtop - Click Element’ Tool step to your Tool by:
  1. Creating a new Tool, then clicking + Add Step
  2. Searching for and adding the ‘Airtop - Click Element’ Tool step
  3. Clicking ‘Expand’ to see the full Tool step
  4. Window ID (Required): Enter the identifier of the browser window containing the page. Type {{ to select a variable from a previous step.
  5. Session ID (Required): Enter the identifier of the browser session. Type {{ to select a variable.
  6. Element Description (Required): Enter a description of the element you want to click. This can be a natural language description (e.g., “the submit button”) or a CSS selector/XPath. Type {{ to select a variable.
  7. Wait Until Timeout Seconds (Optional): Enter the maximum time in seconds to wait for the element to become clickable.
  8. Wait For Navigation (Optional): Check this box if you want the step to wait for page navigation after clicking the element (useful when clicking links or buttons that cause page loads).
  9. Clicking Run step to test out the Tool
The step clicks the specified element on the page. If the element is not found or not clickable within the timeout period, the step will fail.

​
Add the ‘Airtop - Type Text’ Tool step

You can add the ‘Airtop - Type Text’ Tool step to your Tool by:
  1. Creating a new Tool, then clicking + Add Step
  2. Searching for and adding the ‘Airtop - Type Text’ Tool step
  3. Clicking ‘Expand’ to see the full Tool step
  4. Window ID (Required): Enter the identifier of the browser window containing the page. Type {{ to select a variable from a previous step.
  5. Session ID (Required): Enter the identifier of the browser session. Type {{ to select a variable.
  6. Element Description (Required): Enter a description of the input field where you want to type. This can be a natural language description (e.g., “the email input field”) or a CSS selector/XPath. Type {{ to select a variable.
  7. Text to Type (Required): Enter the text you want to type into the element. Type {{ to select a variable, or enter the text directly.
  8. Press Enter Key (Optional): Check this box if you want to press the Enter key after typing the text (useful for submitting forms or triggering search).
  9. Wait Until Timeout Seconds (Required): Enter the maximum time in seconds to wait for the element to become available.
  10. Wait For Navigation (Optional): Check this box if you want the step to wait for page navigation after typing (useful when typing triggers a page load).
  11. Clicking Run step to test out the Tool
The step types the specified text into the target element. If the element is not found within the timeout period, the step will fail.

​
Add the ‘Airtop - Scroll Page’ Tool step

You can add the ‘Airtop - Scroll Page’ Tool step to your Tool by:
  1. Creating a new Tool, then clicking + Add Step
  2. Searching for and adding the ‘Airtop - Scroll Page’ Tool step
  3. Clicking ‘Expand’ to see the full Tool step
  4. Window ID (Required): Enter the identifier of the browser window containing the page. Type {{ to select a variable from a previous step.
  5. Session ID (Required): Enter the identifier of the browser session. Type {{ to select a variable.
  6. X Scroll Amount in pixels (Required): Enter the number of pixels to scroll horizontally. Use positive numbers to scroll right, negative numbers to scroll left, or 0 for no horizontal scrolling.
  7. Y Scroll Amount in pixels (Required): Enter the number of pixels to scroll vertically. Use positive numbers to scroll down, negative numbers to scroll up, or 0 for no vertical scrolling.
  8. Clicking Run step to test out the Tool
The step scrolls the page by the specified pixel amounts. This is useful for loading dynamic content or reaching specific sections of a page.

​
Common use cases

  • Filling out forms automatically
  • Clicking buttons and links to navigate through a website
  • Scrolling to load dynamic content or reach specific page sections
  • Automating repetitive user interactions

​
Common errors

This error occurs when trying to click an element that is not currently visible or clickable. You may need to wait for the element to load or scroll to make it visible.

​
Frequently asked questions (FAQs)

For dynamic content that loads asynchronously, consider using the ‘Airtop - Monitor page for condition’ step to wait for elements before interacting with them.
The Type Text step handles standard text input. For special keys or keyboard shortcuts, you may need to use additional automation steps.