Precision settings allow you to customize the way WalkMe identifies elements on your website. Using Precision Settings you can see how easily WalkMe identifies a given element on your site and modify the way the WalkMe Algorithm works. Modifying Precision settings optimizes the way that WalkMe’s Algorithm performs on your site and is usually used to resolve issues or to maximize performance.
- Increase the Precision level of the algorithm if WalkMe Items appear on incorrect elements on your site
- Decrease the Precision level of algorithm if WalkMe cannot find your select element
- Ignore the text of your element if it may appear in multiple languages
- Ignore the ID for an element on your website when it changes constantly
- Use a jQuery Selector for Launchers that are Strong Pinned to optimize performance
- Ignore the position of a button that might move on the screen depending on the size of your browser window
When an element is difficult to identify, has a low precision score, or when the code and layout of your site change whenever a page loads or if the screen size changes, WalkMe may have trouble locating your selected element. When this happens WalkMe may misidentify the element on the page or simply not play your WalkMe item. To customize the way that the WalkMe algorithm works on your site you use the Precision tool to modify settings. Some Precision settings are modified globally, to all elements, by our specialists if we know that it’s necessary on your site, so it’s important to check with your CSM if you plan to change precision settings.
Test an element’s grade by visiting the page on which your WalkMe Item should appear and open the Precision Settings. WalkMe analyzes the current page in the browser and gives the element a grade. If it does not see the element on this page, you will receive message “The element is not available on this page.”
View Element Grade in the Flow Tracker when testing a Smart Walk-Thru to the right of the step. The Flow Tracker displays a “looking for element” magnifying glass icon until it locates the element on the page. Once the element is located, the Element Grade will appear to the left of the step in the Flow Tracker.
For elements used in a Rule, click the Rule in the Flow Tracker. If the element is found on the page then an eyeball with a check mark appears, if the element is not found then an exclamation point appears.
Generally, we regard three (3) bars or higher as a good score. Elements that less than three (3) bars may still be identified consistently by WalkMe, but it’s recommended that you properly test these WalkMe Items to ensure that they do find your desired element. When using jQuery Selectors Precision does not display an Element Grade because it uses your selector to identify the element. Learn more about jQuery Selectors.
After an element is selected use Precision Settings to view the Element Grade and to modify the way the algorithm works. Precision Settings are located in the options menu for your WalkMe items. To re-select your element, click Re-Select Element at the bottom of the options menu.
For Rules that use elements click the Re-select Element icon on your rule statement.
IMG of Rule Statement with Gear and Re-Select Element icon
Direct WalkMe to focus on certain attributes:
- Default: WalkMe uses the default settings for the algorithm
- Identify by Text: Identifies the element specifically by its text in the HTML code.This is only valid for elements that actually contain text that is identified in the HTML; some elements with text are images but do not contain text. When this option is selected, the text from the element will autofill in the input field (without spaces, not case-sensitive). Notice that when choosing this option, you can't use any other bypass options.
- jQuery Selector: Using a jQuery selector is the most precise way to identify an element because it allows you to create a custom selector to identify the element. Use a custom jQuery Selector when an element is very difficult for WalkMe to identify. Writing a jQuery Selector can help WalkMe to find elements if you use both multi-language and your website has dynamic IDs (the element's code changes when the page is reloaded).
Direct WalkMe to ignore certain attributes.
- Text: The algorithm ignores any HTML text within the element (number, text, or character). Bypass text for elements that appear in multiple languages or that may use dynamic text.
- ID: The algorithm ignores the element ID in the HTML code. If the Element you selected has a variable or dynamic ID (ID is constantly changing when a page is loaded), configure WalkMe to ignore ID.
- Position: The algorithm ignores the position of the element on screen. Use if an element changes location on screen. This may happen if your user has a different screen size and your site is designed to reformat the layout If you would like to apply one of these bypass options to all elements captured, contact your CSM who can quickly add this feature.
When WalkMe checks the page for an element, it analyzes all elements that match most of the attributes on the page and gives it a numerical score. The algorithm selects the element with the highest score and plays the step.
- High: Use this setting if elements similar to the one that was chosen are being identified by WalkMe (i.e. steps or launchers appear on the wrong element). Setting to High should avoid misidentification.
- Medium: This is the default WalkMe Precision Level and is sufficient in most cases.
- Low: Use this setting in cases where the algorithm has a hard time finding an element because the position of elements is constantly changing. Use this setting if WalkMe cannot find your element on the page.
An Element Grade less than 3 bars is not necessarily an issue. Start by testing out your Smart Walk-Thru in Preview mode and even on a Test environment of your website. Your item may not actually have any issue, but if WalkMe cannot find your element or it appears on the wrong element use the steps listed below.
I need to Strong Pin a Launcher or SmartTip
If you want WalkMe to continually look for an element so that when it appears a Launcher or SmartTip will be displayed, then you must add a jQuery Selector in the Precision. jQuery Selectors help WalkMe to identify your element without affecting performance. Using Strong Pin on a Launcher or SmartTip without adding a jQuery Selector may cause performance issues and is not recommended.
Smart Walk-Thru Step, Launcher or SmartTip appears on the wrong element.
Try changing your Precision level to High or re-selecting the element. If the issue persists try using the Identify by Text type or writing a jQuery Selector. If you use Multi-Language avoid Identify by Text and use a jQuery Selector.
Smart Walk-Thru Step, Launcher or SmartTip element cannot be found.
Try changing your Precision level to Low or re-selecting your element. If the issue persists, try using some of the Bypass options. Often ignoring ID can resolve any issues if an element’s ID changes whenever a page is reloaded. If this does not help them use a jQuery Selector.
Try it Out
- Create a Smart Walk-Thru Step. Open your Precision settings and see how the Element Grade changes when you select different Precision Levels and Bypass options.
- For a Rule that uses On Screen Element or Selected Element click the Gear icon and check your Element Grade. When selecting an element, try using the Expand Selection and Narrow Selection buttons to see how your selection and element grade changes.