Skip to main content Skip to docs navigation

Page Guard

Only run a step if a value on the page meets your condition — check text, attributes, or browser values before the step executes.

Only run this step if a value on the page meets your condition.

Page Guard checks the page before a step executes. You can read text or attributes from any element, evaluate browser values like the current time or URL, compare them against your criteria, and decide whether to proceed.

To open Page Guard, click the three-dot menu at the end of a step row and choose Page Guard.

Find Item on Page

The element or value to evaluate. This is what Page Guard reads before running the step.

You can use any selector type supported by the step Element Finder — XPath, #id, ClassName::, Name::, TagName::, querySelector::, or Position::x,y.

Browser Functions (Func::)

Instead of a page element, you can evaluate a JavaScript expression by prefixing with Func::.

ExpressionReturns
Func::new Date().getHours()Current browser hour (0–23). See Date for all methods.
Func::location.hrefCurrent page URL. See Location for all properties.
Func::<expression>Any valid JavaScript expression that returns a value.

Only use Func:: expressions you wrote yourself or fully understand. Malicious scripts can act on your behalf and violate your privacy.

Func:: is only available in Page Guard. Using it in a step's Element Finder will cause an error.

Compare

How the page value (a) is compared to your input (b).

ConditionTypesDescription
EqualsString, Number(a) equals (b)
Not EqualsString, Number(a) is not equal to (b)
ContainsString(a) contains (b)
Not ContainsString(a) does not contain (b)
Greater ThanNumber(a) > (b)
Less ThanNumber(a) < (b)
Greater Than Or EqualNumber(a) ≥ (b)
Less Than Or EqualNumber(a) ≤ (b)
Is CheckedBooleanCheckbox or radio is checked
Is Not CheckedBooleanCheckbox or radio is not checked

Compare With

The expected value to compare against. This is (b) in the comparison.

  • Enter text to match exactly or partially (depending on the chosen condition).
  • Enter a number for numeric comparisons (Greater Than, Less Than, etc.).
  • Leave blank for boolean conditions (Is Checked, Is Not Checked).

Extract Number or Text

Use a regular expression to extract part of the element's text before comparison. Useful when the text includes currency symbols, labels, or surrounding content.

Examples:

  • \d+\.\d*$123.00123.00
  • \d+$123.00123
  • (?<=\$)[\d,]+(?:\.\d+)?$1,234.561,234.56
  • \d{4}-\d{2}-\d{2}Updated: 2024-07-012024-07-01
  • (?<=Total:\s)\d+Total: 42 items42

Try your pattern at regex101.com.

Attribute tips: - @aria-checked — extracts the aria-checked value (e.g., true/false) - @class — extracts the full class string; use a regex like (^|\s)active(\s|$) to check for a single class - @type — extracts the type attribute (e.g., checkbox) - @data-status — any attribute by replacing data-status with the actual name

If Condition Not Met

Page Guard Recheck

Choose what should happen if the filter condition is not met.

Check Again

How many times to retry the Page Guard condition when it does not match initially.

  • Enter a positive number for a fixed retry limit, for example 5 to try five times.
  • Click the infinity button (∞) to keep retrying until the condition matches.
  • Leave it blank to check only once.

Unlimited mode

Click the ∞ button next to the input to switch to unlimited mode. The number input is disabled and the extension keeps retrying until the element is found or the automation is stopped manually.

Wait Before Checking Again (sec)

How long to wait between each retry attempt, in seconds.

  • Enter a single number for a fixed delay, for example 2 for a 2-second pause between retries.
  • Click the range button to set a random delay between a minimum and maximum.
  • Leave it blank to retry immediately.

Examples (seconds)

  • 0.5 — half a second
  • 1 — one second
  • 1.5 — one and a half seconds
  • 2 — two seconds
  • From 1 and To 4 — random value between 1 and 4 (enable range mode first)
  • From 2 and To 3 — random value between 2 and 3 (enable range mode first)
  • From 0.5 and To 1.5 — random value between 0.5 and 1.5 (enable range mode first)
  • Leave blank to use the default value (or start immediately, depending on the field)

What happens if the condition is never met

OptionDefaultDescription
Stop AutomationselectedStop the full automation immediately. No further steps run.
Skip This Stepnot selectedSkip this step and continue with the next one.
Refresh & Retrynot selectedReload the current page and try again.
Go to Stepnot selectedJump to a specific step in the list.