Skip to main content

​
Target Element Selector

Target element selectors allow us to track user events and place interactive GuideWhale content relative to your existing application elements.

​
Match Text

Determines if we should use your target element’s text content as a selector by default (can also be configured for each selector separately). This should generally remain enabled unless your application heavily relies on dynamic text content that differs between application versions or logged-in users.

​
Selector Precision

Determines how precise should GuideWhale be when generating selectors of your target elements. It is recommended to leave this at Highest unless you regularly run into issues where GuideWhale cannot find the target element. In that case please contact our support at [email protected].

​
Excluded Selectors

Some application will use dynamic HTML attributes which change between application versions and deployments. To guarantee consistency, we must exclude these attributes when targeting and attaching GuideWhale content to your existing elements. You can exclude the following attributes:
  • ID: element unique identifier. Some frameworks might re-generate unique ids for some elements after every deployment and those typically starts with a prefix (e.g. id="fw-1234abcd", where excluded selector should be ID starts with fw-).
  • Class: element class selector. Some frameworks might re-generate unique classes after every deployment and those typically start with a prefix (e.g. class="svelte-1234abcd", where excluded selector should be Class starts with svelte-).
  • Tag: element tag name. Should only be used in specific cases where your custom tag names might change over time (e.g. <custom-tag>...</custom-tag>, where excluded selector would be Tag equals custom-tag).
  • Attribute: any custom attributes you want to exclude. Typically, this is used for data attributes with dynamic values (e.g. data-id="123", where the excluded selector should be Attribute equals data-id).
You can use the following operators to exclude attribute values:
  • equals: target element selector value matches exactly.
  • contains: target element selector value contains the value.
  • starts with: target element selector starts with the value.
  • ends with: target element selector ends with a value.
  • matches pattern: target element matches a * pattern string, where * is a wildcard for any sequence of characters.
  • matches regex: target element matches a specific regex pattern.
If you’re unsure about these settings and what dynamic selectors should be excluded, please consult with your development team or contact our support at [email protected].