Skip to main content
The Retry command retries a container command when a configured condition is true. Use it to recover by rerunning the Agent, a parent command, a parent list entry, a parent pagination command, or a specific command. Located under Other in the command palette.

​
Configure a retry condition

Build a condition from the selected XPath and apply transformations when needed. Retry command selection and transformation settings For example, if the condition is satisfied, return the name of the retry command; otherwise, return an empty string. Example Retry command condition

​
Command properties

​
Configure retry

Retry configuration settings

​
Basic

Use Basic to configure the conditions that determine whether to execute or skip the Retry command.
  • Data source: The source of the data consumed.
    • Data List: Uses data from the parent Data List command. Select the specific Data List and the name of the subcommand or column from which to retrieve data. A transformation is also available for further customization.
    • Command: Uses the parent command or the parent’s parent command as the Retry command’s data source. A transformation is also available for further customization.
    • Agent Parameter: Uses input parameters as the Retry command’s data source. A transformation is also available for further customization.
    • Action Result: Uses an action result as the input data source. Available results include Page HTML, Page URL, and Is Error.
    • Selected Content: Compares the content of a selected web element with a specified constant.
  • When hidden or disabled: Controls how the Agent handles selected elements based on their visibility or enabled state.
    • Select: The Agent selects visible and disabled elements that match the XPath.
    • Ignore: The Agent selects only elements that are present and enabled—that is, elements that match the XPath and are interactable.
  • Retry when data source: Specifies the condition type and comparison logic. It includes unary and binary operators such as:
    • Empty / Not Empty
    • Equals / Does Not Equal
    • Greater Than / Greater Than or Equal
    • Less Than / Less Than or Equal
    • Contains / Does Not Contain
    • Starts With / Ends With
    • Matches / Does Not Match
    • Always True / Always False
  • Retry command: Specifies the command to retry based on the selected scope and retry conditions.
    • Default: Retries the parent List Entry the specified number of times.
    • Agent: Retries the entire Agent the specified number of times.
    • Parent Command: Retries the immediate parent command the specified number of times.
    • Parent List Entry: Retries the parent List Entry command the specified number of times.
    • Parent Pagination Command: Retries the parent pagination command the specified number of times.
    • Specific Command: Retries the command defined in the Specific Command field the specified number of times.

​
Scripting

  • Language: Specifies the scripting language to use, such as Regex, C#, Python, or JavaScript.

​
Retry settings

The Retry settings section determines the maximum number of retry attempts and what the Agent controller does if content still does not load after those attempts. Retry settings
  • Max. retries: Defines the maximum number of attempts a container command makes before stopping. The default is 5, but you can adjust it.
  • Action after max. retries: Determines what happens when the maximum retry count is reached.
    • Restart Agent: Restarts the Agent after completing the specified retry actions.
    • Continue: Moves on to the next command, ignoring the retry limit.
    • Exit Parent: Exits the parent command after the specified retry actions.
    • Exit Retry Target: Exits the specific command defined by the condition after the specified retry actions.
  • Delete data row on exit: When set to Yes, deletes the current data entry when exiting. This deletes the current data row generated by the closest parent List command. The default is No, which keeps the current data row when exiting.
  • Rotate proxy on error: Rotates to a different proxy on each retry attempt after an error occurs. This option is unchecked by default.
  • Random delay between retries: Sets the number of seconds to delay a retry. This option is disabled or unchecked by default.