Actions are tasks that PageCrawl executes in the browser before taking a page snapshot. They let you automate interactions like dismissing cookie banners, clicking tabs, logging in, scrolling to load content, or waiting for dynamic elements to appear.
Actions are configured per tracked element and execute in order from top to bottom.
Where to Configure Actions
Open any monitored page and click Edit. In the page configuration form, find the Actions section. Click Add Action to add a new action, then select the action type from the dropdown.
Available Actions
Error Handling
| Action | What It Does |
|---|---|
| Mark as failed | Mark the check as failed when conditions are met (page inaccessible, contains specific text, etc.) |
Block and Hide
| Action | What It Does |
|---|---|
| Block cookie banners & ads | Automatically hide cookie consent banners and block ads |
| Hide website overlays & popups | Hide website overlays and popups |
| Remove dates | Replace dates with "[DATE REMOVED]" to prevent false positives |
| Remove element | Remove a specific element by CSS or XPath selector |
| Remove text | Remove elements containing specific text |
Wait
| Action | What It Does |
|---|---|
| Wait for text | Wait up to 15 seconds for specific text to appear on the page |
| Wait for text to disappear | Wait up to 15 seconds for specific text to disappear |
| Wait for element | Wait for an element (by XPath or CSS selector) to appear |
| Wait for redirect | Wait for the page to redirect to a new URL |
| Wait | Pause for a specified number of seconds |
Interact
| Action | What It Does |
|---|---|
| Click button | Click an element containing specific text |
| Click element | Click any element by CSS or XPath selector |
| Click at coordinates | Click at specific X/Y pixel coordinates |
| Hover | Hover over an element |
| Type text | Type text into an input field |
| Select option | Select an option from a dropdown |
| Submit form | Submit a form |
| Scroll to bottom | Scroll the page to the bottom (useful for lazy-loaded content) |
| Go back | Navigate back in browser history |
| Reveal hidden text | Make hidden text visible. Has two modes: "Expandable Sections Only" (expands collapsible sections and accordions) and "All invisible text" (reveals all hidden text on the page) |
Advanced
| Action | What It Does |
|---|---|
| Disable JavaScript | Disable JavaScript before the page loads |
| Set cookie | Set or manage browser cookies |
| Execute JavaScript | Run custom JavaScript code on the page |
| Store Contents for Tracked Element | Store a tracked element's value at this point in the action sequence, useful when the element is only visible after a specific interaction |
| Handle CAPTCHA | Interact with CAPTCHA challenges |
Common Use Cases
Dismiss cookie banners: Add a "Block cookie banners & ads" action to automatically hide consent popups and ads that can trigger false change notifications.
Load lazy content: Add "Scroll to bottom" followed by "Wait" (2-3 seconds) to load content that only appears when scrolling.
Navigate to a tab or section: Add a "Click element" action with the CSS selector of the tab you want to monitor.
Login to a page: Add "Type text" actions for username and password fields, followed by "Click button" to submit the login form.
Wait for dynamic content: Add "Wait for text" with the text that appears after the page finishes loading (e.g., "Showing results").
