Skip to main content
Workflow settings control behavior that applies across all nodes and runs. You can configure these in the dashboard under the General tab of a workflow, or via the Workflow API.

​
Execution Settings

Additional error handling and recovery settings (such as XPath recovery, popup handling, and timing recovery) can be configured under the Maintenance Agent.

​
Video Recording

video_record_session — When enabled, the agent records a video of the browser session during execution. Useful for debugging and auditing. popup_xpaths — An array of XPath selectors pointing to elements that dismiss unwanted popups (e.g., a close button on a cookie banner or promotional modal). During execution, the agent checks for these elements before and after every action (click, input text, input select, scroll, extract). If a matching element is found and visible, the agent clicks it and waits briefly for the popup to close. If a popup appears during an action (e.g., intercepting a click), the agent automatically retries the action. 
{
  "popup_xpaths": [
    "//button[@aria-label='Close']",
    "//div[@id='cookie-banner']//button[contains(text(), 'Accept')]"
  ]
}
Use XPaths that target the dismiss element (close button, “Accept” button), not the popup container itself.
If Popup Handling is enabled, the maintenance agent will automatically add XPath selectors to the popup_xpaths array when it encounters and recovers from unexpected popups.

​
Proxy Settings

​
Proxy Setting

proxy_setting — Controls proxy behavior for the workflow. Possible values:
ValueDescription
"off"No proxy (default)
"residential"Use a residential proxy
"custom"Use a custom proxy URL specified in proxy_value

​
Proxy Value

proxy_value — The proxy URL or region when proxy_setting is "residential" or "custom".