General Settings

General settings for configuring the chat widget:

Property	Default	Description
`delayBetweenBotMessages`	1000	The synthetic delay added by the widget if the DG bot sends multiple messages in a row.
`messageAnimationDuration`	300	The duration of the animation on messages entering the widget.
`enableInactiveTabNotifications`	true	Enables a notification in the page title about new messages when the page is not focused.
`hasDragAndDropAttachment`	true	Enables drag-and-drop functionality for file uploads.
`hasSendButton`	true	Whether the send message button is enabled.
`headerIcon`	''	The icon displayed in the pre chat form and widget header. Can be an image url or base 64 encoded image.
`isAnimationDisabled`	false	Disables widget mount/unmount animations.
`isChatCloseControlEnabled`	true	Whether the dialog close control is enabled or not.
`isChatMinimizeControlEnabled`	true	Whether the dialog minimize/expand controls are enabled or not.
`isDialogMaximised`	false	Whether the widget should be maximized on page load.
`isChatLauncherEnabled`	true	Whether the chat launcher is enabled. If set to `false`, the widget must be manually launched.
`launcherVariant`	''	Which pre defined launcher to use. `star`, `smile` or `chatBubbles`.
`maskCreditCardNumbers`	true	Redacts any credit card or IBAN numbers entered into the widget before they are displayed or transmitted to any server.
`showDownloadAttachmentsButton`	true	Whether to show the download button for attachments.
`enableCrmUserAttachments`	true	Enables the user to upload attachments after handing over to an agent. Only applies to Sunco and Gorgias.
`enableNavigationTracking`	true	Adds a system event to the conversation page when the user navigates to a new page. May not work for some single-page apps. Use the `trackNavigation` method.
`enableDGPoweredByLink`	true	Whether the 'Powered by DigitalGenius' link is displayed and linked to the DG website.
`persistSession`	true	Persists the session between page reloads or multiple tabs. Disabling this is useful for WISMO widgets.
`isEmbeddedMode`	false	When `true`, the widget is maximized by default, and when the user closes the chat, the conversation ends, but the widget remains open with the pre-chat form.
`isWidgetDisabled`	false	When `true`, the widget will not be displayed.
`maxUserMessageLength`	250	The maximum number of characters a user can send in a message.
`csatCloseButtonDisabled`	false	Whether the csat close button is disabled or not.
`enableUnreadNotification`	true	Whether to enable the unread notification on the launcher when messages are received whilst chat is minimised.
`enableBackToBottomButton`	true	Whether to display the back to bottom button when the user scrolls up in the conversation.
`closeChatAfterAgentInitiatedCsat`	false	When `true`, after a helpdesk agent has ended the chat the widget will close after the user has provided csat
`externalLaunchElement`	null	Launch the widget from an external element on the webpage. Must be a valid css selector accepted by `document.querySelector`
`endExpiredSessionOnTabFocus`	false	When `true`, the widget will check if the session has expired when the tab gains focus. If the session has expired, the widget is closed and the session ends.
`sendMessageOnEnterKey`	true	When `true`, messages are sent when the user presses the `Enter` key. Otherwise the `Enter` key will add a new line (recommended for Japanese users).
`openLinksInNewTab`	true	When `true`, any links within chat will open in a new tab, rather than the same window.