Configuration and Settings

📘

Drift Privacy Policy

Drift respects privacy rights and data protection laws. You may only share other people's personal information with Drift, whether directly or through third-party integrations, if you are permitted to do so under applicable law. Drift Privacy Policy

With the API you can also control many aspects of the widget configuration. Call drift.config with one or more of the options described below to change the widget's configuration for that session.

First, Initialize the Drift Widget

<script>
drift.on('ready',function(api, payload) {
 // your code goes here
})
</script>

<script>
analytics.ready(function(){
    //your code goes here
})
</script>

Drift Config Example

<script>

  drift.config({
   locale: 'en-US',
    messages: {
     welcomeMessage: 'Hey there!',
      awayMessage: "Hey, we're not here right now, but leave a message.",
      emailCaptureMessage: "Leave your email so we can get back to you.",
      thankYouMessage: "Thanks we'll follow up soon."
    },
    enableWelcomeMessage: false,
    enableCampaigns: false,
    enableChatTargeting: false,
    backgroundColor: '#000000',
    foregroundColor: '#ffffff',
    autoAssignee: {
      name: 'Trevor Rundell',
      title: 'Engineer',
      email: '[email protected]',
      avatarUrl: 'https://s.gravatar.com/avatar/...',
    },
    inboxId: 99999,
    cookieDomain: '.example.com',
    disableNewConversations: true
  })
  
</script>

Configuration Options:

Moving the widget vertically

This functionality can now be updated directly in the UI here. You can easily customize your mobile and desktop widget alignment to the left or right, then adjust the spacing from the bottom of the screen. For example, moving the widget up 70 pixels from the default spacing.

You may also use the verticalOffset property in your drift configuration to move {x} number of pixels from the bottom of the page.

<script>
  drift.config({
   verticalOffset: 70,
  })
</script>

Moving the widget horizontally

Similar to moving the widget vertically, but this time we're going to move it horizontally using the horizontalOffset property.

<script>
  drift.config({
   horizontalOffset: 70,
  })
</script>