Brief Overview

Smart Walk-Thru Split and Error Handling steps are designed to evaluate the state of the application and determine the next step in a flow. If these steps are not behaving as expected, it is often due to timing issues or page loading states.

Troubleshooting Steps

If a Split or Error Handling step is failing to trigger or is taking the wrong path, follow these steps to resolve the issue:

Check for page load timing

If the step triggers too quickly before the application finishes loading, WalkMe may not find the element or condition required.

• Add a Wait for flow step immediately before the split or error handling step
• Set the Wait for condition to pause the flow for 1 or 2 seconds before the conditions are evaluated or to look for an element that confirms the page is ready
• Ensure the timeout is sufficient for slower network speeds

Wait For Steps: Getting Started Guide

Review rule configuration

If you use multiple rules in a condition, ensure they are grouped correctly with the appropriate operators.

• Verify the And / Or operators between multiple statements
• Confirm that jQuery syntax is correct if using technical selectors
• Adjust element precision if an on-screen element is not consistently identified

Address elements in iframes

If the element being evaluated is located inside a cross-domain iframe, WalkMe requires a specific flow to access it.

• Add a Switch to Frame step before the split/error handling group
• Ensure the element is correctly identified within the iframe boundaries

Switch to Frame Flow Steps

Use the Flow Tracker for debugging

The Flow Tracker provides real-time data on why a step might be failing.

• Open the Flow Tracker 
• Run the Smart Walk-Thru to the point of failure
• Review the specific error message provided for the split or error handling step

Flow Tracker

Best Practices

• Use unique elements for conditions to avoid false positives
• Test your logic in multiple browser environments to ensure consistency
• Keep conditions simple to reduce processing time during the flow