---
title: "Configure Global Settings using Technical configurations"
slug: "set-technical-preferences-for-your-whatfix-account"
status: "update"
updated: 2026-01-06T06:03:13Z
published: 2026-01-06T06:03:13Z
canonical: "support.whatfix.com/set-technical-preferences-for-your-whatfix-account"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.whatfix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configure Global Settings using Technical configurations

The Technical configuration section enables you to configure specific Whatfix settings directly from the Guidance dashboard at a global level. Any changes made here apply across the entire Whatfix deployment, ensuring consistency in settings and behaviors.

The following table provides a list of all the configurations that can be set up:

### Analytics

| Preference Title | Description |
| --- | --- |
| [GA Exclude Optional Dimensions](/studio/docs/set-ga-exclude-optional-dimensions) | When enabled, this preference reduces data sent to [Google Analytics](/studio/docs/google-analytics) using smaller and more secure GET calls, potentially avoiding data loss from blocked POST requests due to large payloads. However, this might result in some data being omitted. |
| [Proxy Domain](/studio/docs/set-a-proxy-domain) | When enabled, set up a forward proxy on your network using a custom domain to receive Analytics calls. These calls are then forwarded to the `http://whatfix.com` endpoint. |

### Common Properties

| Preference title | Description |
| --- | --- |
| Detect app on url change | When enabled, Whatfix detects changes in the application URL, enabling it to adapt to the new page or application state without requiring a full page reload. |
| [Capture Elements from Composed Path](/studio/docs/capture-elements-from-composed-path) | When enabled, Whatfix uses the `composedPath()` method to identify elements in your application. |
| [Smart Detect Performance](/studio/docs/improve-smart-detect-performance-using-technical-configurations) | When enabled, Whatfix improves Smart Detect performance by reducing multiple element detection calls when an element selector is provided. |
| [Whatfix Positioning Adjustment](/studio/docs/adjust-whatfix-content-when-body-position-is-relative) | When enabled, Whatfix ensures that all the Whatfix content appears where they should, even when the underlying application has relative body positioning. |
| [Content sync for continuous mutations](/studio/docs/set-technical-preferences-for-your-whatfix-account) | When enabled, Whatfix ensures that the [Mutation Observer](/studio/docs/mutation-observer-config)'s callback executes at a fixed interval, even when ongoing [DOM](https://developer.mozilla.org/en-US/docs/Web/API/Document_Object_Model) mutations continue to occur. |
| [Mutation Observer Config](/studio/docs/mutation-observer-config) | When enabled, Whatfix monitors mutations whose type matches this configuration. This preference is used by Smart-Tips, Beacons, and Launchers. |
| Injects script on demand in both src and no src iframes | When enabled, Whatfix injects scripts on demand for Studio extensions in iframes, regardless of whether the iframe has a `src` attribute or not. This ensures that content creation and guidance execution work correctly even within embedded or dynamically loaded frames. |
| [Overflow hidden check required](/studio/docs/overflow-hidden-check-required) | When enabled, Whatfix evaluates hidden elements that become visible only on a scroll action. |
| [Override text content with inner text](/studio/docs/override-text-content-with-inner-text) | When enabled, Whatfix captures the `innerText` property of the selected element instead of the `textContent` property. |
| [Mutation Observer Config for Smart Context](/studio/docs/mutation-observer-config) | When enabled, Whatfix monitors mutations whose type matches this configuration. This configuration is used by [Smart Context](/studio/docs/smart-context) to re-evaluate all widgets if Page Tags have changed due to these mutations. |
| [Mutation Throttle Interval for Smart Context (ms)](/studio/docs/mutation-throttle-interval-ms) | When enabled, Whatfix re-evaluates all widgets only if the page is stable for a certain time interval. By stable, it means there is no change in page structure for that time interval. This time interval can be changed using this preference. |
| [Real time rule validation](/studio/docs/enable-real-time-rule-validation) | When enabled, Whatfix provides immediate feedback while using the new Visibility Rules during content and widget creation in Studio. Visibility Rules are evaluated directly within the application context, showing whether each condition is valid or invalid as it is added. This reduces trial-and-error cycles and ensures rules function as intended during content creation. |
| [Element reliability indicator](/studio/docs/enable-element-reliability-indicator) | When enabled, Element reliability indicators help you determine whether selected elements in the application are reliable for content creation. They are particularly useful when multiple similar elements exist on a page or when it is difficult to identify a reliable element. These indicators help you to detect weak or unreliable elements early in your workflow, ensuring that content attaches to the correct element and displays as intended. |
| [Single Page Application](/studio/docs/single-page-application) | When enabled, Whatfix considers the current application as a single page application. |
| [Step Configurations](/studio/docs/step-configurations) | When enabled, apply global configurations to tooltips in Flows, Smart Tips, or Beacons. |
| [Top layer support - Dialog](/studio/docs/enable-top-layer-support) | When enabled, Whatfix supports content creation on dialog boxes that appear above the main application interface. This ensures Whatfix content is displayed correctly on these overlay elements, without being hidden or obstructed. |
| [Top layer support - Popover](/studio/docs/enable-top-layer-support) | When enabled, Whatfix supports content creation on popovers that appear above the main application interface. This ensures Whatfix content displays correctly on these overlay elements without being hidden or obstructed. |
| [Z Index](/studio/docs/z-index) | When enabled, set the desired z-index for Whatfix elements. The Z-index property is related to the order in which various HTML elements on a page show up, either in front or behind. If tooltips are showing up behind the HTML elements, then they can be brought to the front by using the z_index property value with a higher value. |

### Flows

| Preference title | Description |
| --- | --- |
| [Flow Tooltip Visibility Check for iFrames](/studio/docs/hide-flow-tooltip-when-selected-element-is-out-of-view) | When enabled, Whatfix automatically hides Flow tooltips when their selected element is hidden. This configuration is applicable only when the selected element is within an iFrame. |
| [Closing Retries](/studio/docs/set-closing-retries-for-flows) | When enabled, this parameter determines the number of retries Whatfix will perform to find the selected element before continuing with the running Flow. This is useful when waiting for a new page, redirect, or page refresh to occur. |
| [Delay State Clearance](/studio/docs/delay-state-clearance-for-flows) | When enabled, Whatfix delays the Flow end state, especially when the subdomain remains the same or when dealing with different domain states. This enables Whatfix to hold Flow progress during page navigation and reloads. |
| [Handle Domains](/studio/docs/manage-cross-domain-flows) | When enabled, Whatfix manages cross-domain Flows in JS Embed cases. This prevents steps from failing when a Flow is created across multiple domains. |
| [Handle SubDomain](/studio/docs/manage-cross-sub-domain-flows) | When enabled, this preference, in conjunction with Handle Domains, stores the Flow state when it is active within the same domain but different subdomains. This means that if a Flow is created across multiple subdomains, then Whatfix is able to prevent the steps from breaking. |
| [Ignore Scroll on Body](/studio/docs/ignore-scroll-on-application-body-for-flows) | When enabled, Whatfix ignores the scrollbar on the application body and automatically scrolls to the element where the Flow step is created. |
| [Message On Close](/studio/docs/display-message-on-close-for-flows) | When enabled, a Flow end message is always shown when the Flow is closed midway or exited. |
| [Optional Step Timeout Duration (ms)](/studio/docs/set-step-timeout-duration-for-flows) | When enabled, Whatfix waits for the specified duration to see if the end user performs an action before moving to the next step. If the action is not performed within the specified time, Whatfix continues to the next step. By default, Whatfix checks for the next step at regular intervals of 500 milliseconds. |
| [Step Timeout Duration (ms)](/studio/docs/set-step-timeout-duration-for-flows) | When enabled, set the time allocated to locate the next step. If Whatfix cannot find the step in the allocated time, it advances to the next step or fails. |

### Self Help

| Preference title | Description |
| --- | --- |
| [Self Help Link Content Query Param](/studio/docs/provide-jwt-token-for-self-help-repository-content) | When enabled, Whatfix provides a [JWT token](/studio/docs/provide-jwt-token-for-self-help-repository-content) for repository content. This token is automatically added as a query parameter whenever repository content is accessed. |
| [Self Help Search History Popup Disable](/studio/docs/disable-self-help-search-history-popup) | When enabled, the search history popup in Self Help does not appear. |
| [Self Help Search Suggest Popup Disable](/studio/docs/disable-self-help-search-suggest-popup) | When enabled, the search suggestions in Self Help do not appear. |
| [Support Chat Target](/studio/docs/change-where-the-self-help-live-chat-opens) | When enabled, the chatbot configured in Self Help opens in either the same tab or a new tab. |
| [Close Self Help on click of application](/studio/docs/close-self-help-on-click-of-application) | When enabled, clicking outside the Self Help widget anywhere on the underlying application closes the Self Help widget. |
| [Disable Self Help Exit Feedback Pop-up](/studio/docs/disable-self-help-exit-feedback) | When enabled, the exit feedback pop-up no longer appears when end users close the Self Help widget. |

### Smart Tip

| Preference title | Description |
| --- | --- |
| [App Initial Load Time](/studio/docs/configure-extended-wait-time-for-smart-tips-in-an-iframe) | When enabled, Whatfix maintains continuous element detection to ensure that any Smart Tips loading within an iframe do not break. |
| [Mutation Exclude Attribute Names](/studio/docs/disregard-application-attributes-during-mutations) | When enabled, Whatfix ignores application attributes during mutations of the application. |
| [Smart Tip Overflow](/studio/docs/configure-smart-tip-visibility-when-selected-element-is-out-of-view) | When enabled, Whatfix assesses the visibility of the select element on the screen. If the element is obscured, hidden, or scrolled out of the viewport, the content is not displayed. This is also applicable to Beacons, and Launchers. |

### User Action

| Preference title | Description |
| --- | --- |
| [Enable Autocapture for selective users](/studio/docs/enable-autocapture-for-selective-users) | When enabled, Whatfix captures end users’ click actions on the application using [Autocapture](/product-analytics/docs/what-is-autocapture), only for specific users based on their User IDs. > [!WARNING] > Note: > > Autocapture is a Beta feature. Contact [support@whatfix.com](mailto:support@whatfix.com?subject=Enable%20Autocapture&body=Hi%20team%2C%0A%0AKindly%20enable%20Autocapture%20for%20my%20account.%0AENT%20ID%3A%0A%0A) to enable it. |
| Display widgets by default | When enabled, Whatfix ensures that any widget visibility remains unaffected in the presence of any User Action related issues. |
| [Mutation Observer Config for User Action](/studio/docs/mutation-observer-config) | When enabled, Whatfix monitors mutations whose type matches this configuration. |
| [Mutation Throttle Interval for User Action (ms)](/studio/docs/mutation-throttle-interval-ms) | When enabled, Whatfix re-evaluates User Actions only if the page is stable for a certain time interval. By stable, it means there is no change in page structure for that time interval. This time interval can be changed using this preference. |

## Related

- [Configure Global Settings for Tooltips and User Actions](/step-configurations.md)