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`	''	Specifies the header icon for the chat dialog.
`initializationDelay`	null	Sets how long to delay the display of the widget UI (in milliseconds).
`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.
`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.