Digital End-User Experience properties and settings
The following Digital End-User Experience properties and settings control behavior such as alert correlation, browser extension metrics collection, and Desktop Assistant notifications. You must have the admin role to update them.
|
Property or setting |
Value |
Type |
Application |
Description |
|---|---|---|---|---|
|
sn_dex.administration_tab_doc_link |
[url] |
string |
Application and Device Health |
Link to the DEX Administration card documentation |
|
sn_dex.alert.correlation_rule.device.period |
300 |
integer |
Application and Device Health |
Period in seconds for correlating similar DEX device alerts based on the message_keyUse zero to turn off the rule. |
|
sn_dex.alert.delete_delay_period |
15 |
integer |
Application and Device Health |
Delay period in minutes after which a closed alert is deletedFor example, if an alert associated with dex_alert_metadata is closed it isn’t deleted for this period. The default is 15 min. |
|
sn_dex.dex_user_ref_mapping |
[JSON] |
string |
Application and Device Health |
Mapping of the sys_user.user_id column to a custom_user_id column, used when the user ID column is customizedSuffix and prefix help in providing transformation between the values. For example, {"prefix": "dex- |
|
sn_dex.enable_dex_action_playbook |
true |
true | false |
Application and Device Health |
Option that turns on the playbook when the required plugins are activeUse for hiding or showing the playbook in the options on the device details page. |
|
sn_dex.extension.push_metrics_interval |
300 |
integer |
Application and Device Health |
Interval in seconds that the browser extension uses to push metrics to the agentThe default is 5 min. |
|
sn_dex.extension.session_timeout |
240 |
integer |
Application and Device Health |
Period in minutes that an open session is timed out using the tab.lastAccessed time The default is 4 hours. Entering 0 turns off this feature. |
|
sn_dex.network_performance_metrics_duration |
7200 |
integer |
Application and Device Health |
Duration of network performance metrics in seconds |
|
sn_dex.saved_custom_report_limit |
10 |
integer |
Application and Device Health |
Maximum number of saved insights reportsOnly reports that are available on the Insights page count toward this limit. |
|
sn_dex.set_location |
true |
true | false |
Application and Device Health |
If set to true, table dex_location is updated by DEX when valid location isn’t found and a new location record is created |
|
sn_dex_content.enable.content.log |
false |
true | false |
DEX Content Playbook |
Option that turns storing of the check execution details in the dex_content_log table on or off |
|
sn_dex_desktop.app_snapshot_version |
2.0.0 |
string |
Desktop Assistant |
Desktop Assistant electron snapshot app version numberYou can use this property during app development. |
|
sn_dex_desktop.app_version |
2.5.0 |
string |
Desktop Assistant |
Desktop Assistant electron app version number |
|
sn_dex_desktop.enable_notification |
false |
string |
Desktop Assistant |
Option that determines whether notifications are sent |
|
sn_dex_desktop.mac_min_version |
2.6.0 |
string |
Desktop Assistant |
Minimum compatible version for desktop application on macOS |
|
sn_dex_desktop.sn_desktop_assistant.notification_time_to_live |
7 |
string |
Desktop Assistant |
Time to live value of notifications to be sent to the Desktop AssistantThis value is the number of days for which the notification is active and any notification older than this value is discarded. Note: The Time-to-Live (TTL) value can be set to a maximum of seven days. |
|
sn_dex_desktop.va_portal_param |
esc |
string |
Desktop Assistant |
Property that specifies the default esc portalIf you use a portal other than esc for ITSM Virtual Agent, you can specify that portal for integration between Desktop Assistant and ITSM Virtual Agent. |
|
sn_dex_desktop.win_min_version |
2.6.0 |
string |
Desktop Assistant |
Minimum compatible version for desktop application on Windows |
---
title: Digital End-User Experience properties and settings
description: The following Digital End-User Experience properties and settings control behavior such as alert correlation, browser extension metrics collection, and Desktop Assistant notifications. You must have the admin role to update them.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/australia/it-operations-management/digital-end-user-experience-dex/dex-properties-settings.html
release: australia
product: Digital End-User Experience \(DEX\)
classification: digital-end-user-experience-dex
topic_type: reference
last_updated: "2026-09-10"
reading_time_minutes: 2
breadcrumb: [DEX Application and Device Health reference, Reference, Digital End-User Experience, IT Operations Management]
---
# Digital End-User Experience properties and settings
The following Digital End-User Experience properties and settings control behavior such as alert correlation, browser extension metrics collection, and Desktop Assistant notifications. You must have the admin role to update them.
<table id="table_uh2_f5s_rdc"><thead><tr><th>
Property or setting
</th><th>
Value
</th><th>
Type
</th><th>
Application
</th><th>
Description
</th></tr></thead><tbody><tr><td>
sn\_dex.administration\_tab\_doc\_link
</td><td>
\[url\]
</td><td>
string
</td><td>
Application and Device Health
</td><td>
Link to the DEX Administration card documentation
</td></tr><tr><td>
sn\_dex.alert.correlation\_rule.device.period
</td><td>
300
</td><td>
integer
</td><td>
Application and Device Health
</td><td>
Period in seconds for correlating similar DEX device alerts based on the message\_keyUse zero to turn off the rule.
</td></tr><tr><td>
sn\_dex.alert.delete\_delay\_period
</td><td>
15
</td><td>
integer
</td><td>
Application and Device Health
</td><td>
Delay period in minutes after which a closed alert is deletedFor example, if an alert associated with dex\_alert\_metadata is closed it isn’t deleted for this period. The default is 15 min.
</td></tr><tr><td>
sn\_dex.dex\_user\_ref\_mapping
</td><td>
\[JSON\]
</td><td>
string
</td><td>
Application and Device Health
</td><td>
Mapping of the sys\_user.user\_id column to a custom\_user\_id column, used when the user ID column is customizedSuffix and prefix help in providing transformation between the values.
For example, \{"prefix": "dex-`blah`", "device\_user\_id\_column": “custom\_user\_id", "suffix": "dex-`blah`”\}
</td></tr><tr><td>
sn\_dex.enable\_dex\_action\_playbook
</td><td>
true
</td><td>
true \| false
</td><td>
Application and Device Health
</td><td>
Option that turns on the playbook when the required plugins are activeUse for hiding or showing the playbook in the options on the device details page.
</td></tr><tr><td>
sn\_dex.extension.push\_metrics\_interval
</td><td>
300
</td><td>
integer
</td><td>
Application and Device Health
</td><td>
Interval in seconds that the browser extension uses to push metrics to the agentThe default is 5 min.
</td></tr><tr><td>
sn\_dex.extension.session\_timeout
</td><td>
240
</td><td>
integer
</td><td>
Application and Device Health
</td><td>
Period in minutes that an open session is timed out using the tab.lastAccessed time The default is 4 hours. Entering 0 turns off this feature.
</td></tr><tr><td>
sn\_dex.network\_performance\_metrics\_duration
</td><td>
7200
</td><td>
integer
</td><td>
Application and Device Health
</td><td>
Duration of network performance metrics in seconds
</td></tr><tr><td>
sn\_dex.saved\_custom\_report\_limit
</td><td>
10
</td><td>
integer
</td><td>
Application and Device Health
</td><td>
Maximum number of saved insights reportsOnly reports that are available on the Insights page count toward this limit.
</td></tr><tr><td>
sn\_dex.set\_location
</td><td>
true
</td><td>
true \| false
</td><td>
Application and Device Health
</td><td>
If set to true, table dex\_location is updated by DEX when valid location isn’t found and a new location record is created
</td></tr><tr><td>
sn\_dex\_content.enable.content.log
</td><td>
false
</td><td>
true \| false
</td><td>
DEX Content Playbook
</td><td>
Option that turns storing of the check execution details in the dex\_content\_log table on or off
</td></tr><tr><td>
sn\_dex\_desktop.app\_snapshot\_version
</td><td>
2.0.0
</td><td>
string
</td><td>
Desktop Assistant
</td><td>
Desktop Assistant electron snapshot app version numberYou can use this property during app development.
</td></tr><tr><td>
sn\_dex\_desktop.app\_version
</td><td>
2.5.0
</td><td>
string
</td><td>
Desktop Assistant
</td><td>
Desktop Assistant electron app version number
</td></tr><tr><td>
sn\_dex\_desktop.enable\_notification
</td><td>
false
</td><td>
string
</td><td>
Desktop Assistant
</td><td>
Option that determines whether notifications are sent
</td></tr><tr><td>
sn\_dex\_desktop.mac\_min\_version
</td><td>
2.6.0
</td><td>
string
</td><td>
Desktop Assistant
</td><td>
Minimum compatible version for desktop application on macOS
</td></tr><tr><td>
sn\_dex\_desktop.sn\_desktop\_assistant.notification\_time\_to\_live
</td><td>
7
</td><td>
string
</td><td>
Desktop Assistant
</td><td>
Time to live value of notifications to be sent to the Desktop AssistantThis value is the number of days for which the notification is active and any notification older than this value is discarded.
**Note:** The Time-to-Live \(TTL\) value can be set to a maximum of seven days.
</td></tr><tr><td>
sn\_dex\_desktop.va\_portal\_param
</td><td>
esc
</td><td>
string
</td><td>
Desktop Assistant
</td><td>
Property that specifies the default esc portalIf you use a portal other than esc for ITSM Virtual Agent, you can specify that portal for integration between Desktop Assistant and ITSM Virtual Agent.
</td></tr><tr><td>
sn\_dex\_desktop.win\_min\_version
</td><td>
2.6.0
</td><td>
string
</td><td>
Desktop Assistant
</td><td>
Minimum compatible version for desktop application on Windows
</td></tr></tbody>
</table>**Parent Topic:**[DEX Application and Device Health reference](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-operations-management/digital-end-user-experience-dex/dex-console-reference.md)
| title | Digital End-User Experience properties and settings |
| description | The following Digital End-User Experience properties and settings control behavior such as alert correlation, browser extension metrics collection, and Desktop Assistant notifications. You must have the admin role to update them. |
| locale | en-US |
| canonical_url | https://www.servicenow.com/docs/r/australia/it-operations-management/digital-end-user-experience-dex/dex-properties-settings.html |
| release | australia |
| product | Digital End-User Experience \(DEX\) |
| classification | digital-end-user-experience-dex |
| topic_type | reference |
| last_updated | 2026-09-10 |
| reading_time_minutes | 2 |
| breadcrumb | DEX Application and Device Health referenceReferenceDigital End-User ExperienceIT Operations Management |