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.

Maximising widget with URL parameter

The widget can be maximised on page load when the current page url contains the parameter dg-widget-launch.

For example:

www.google.com?dg-widget-launch

www.google.com?some-other-param&dg-widget-launch

For this functionality to work, you must ensure you haven't explicitly set isDialogMaximised: false in config.