How does Whatfix Mobile identify an element by reference?

Sometimes when you're identifying an element on a screen, Whatfix Mobile is unable to find unique identifiers associated with it. In such cases, the element can be identified using a reference. This means that Whatfix Mobile locates the element based on its position in reference to some other element. For example, suppose you want to show a Beacon on a certain option in the menu bar where multiple similar options exist. In that case, Whatfix Mobile identifies the desired option based on its position relative to the menu bar as a whole.

If the selected element is identified via reference, then an orange box appears around it.

Prioritize the first element when multiple similar elements exist

Consider that you're creating content on a page where elements share non-unique IDs, such as on pages that have a lot of elements in a scrollable box, grid, or list. These elements have common identifiers on each row, which can make selecting a specific element challenging due to a lack of distinct identification.

If you want to always target the first element among those sharing a common identifier, enable the Remove Reference toggle to always prioritize the first element. For example, you can enable this toggle if you have a list of users and you want to always show a tooltip only on the first username.

Change the reference of the element

You may want to change the point of reference for the selected element to something that is more stable or unique.

Use the following steps to change the reference of the element:

1. In the Target Element section, click the Settings icon.
   

2. Choose the required Reference Element.
   

3. Click Change reference.