How do I customize the Web Widget (Classic) in my Help Center using APIs?

Question

How can I customize the Web Widget (Classic) in my Help Center using APIs?

Answer 

If you have the Web Widget (Classic) embedded in your Help Center and you want to customize its settings using the Web Widget (Classic) API, you can do so by modifying your Help Center theme's document_head.hbs template file.

To add your custom Web Widget (Classic) settings, follow these steps:

1. In Guide, click the Customize design icon ().
2. Click the theme you want to edit to open it.
3. Click the options menu, then select Edit Code.
4. In the Templates section, click document_head.hbs to modify the code.
5. Place the desired code below the first <header class="header"> line, and above the final header line.

For example, if you want to change the positioning of your Web Widget (Classic) in your Help Center, use this API setting:

<script type="text/javascript">
  window.zESettings = {
    webWidget: {
      offset: { horizontal: '100px', vertical: '150px' }
    }
  };
</script>

This is what this should look like in the document_head.hbs file:

 ​
For more information on making customizations to the Web Widget (Classic) and your Help Center, see the articles:

• Advanced customization of the Web Widget (Classic)
• Customizing your Help Center theme (Guide Professional and Enterprise)