image for site

Customize Zendesk Web Widget (Classic) with APIs

Learn how to customize the Zendesk Web Widget (Classic) using APIs by modifying the document_head.hbs template file in your help center.

How do I customize the Web Widget (Classic) using APIs in Zendesk?

To customize the Web Widget (Classic) in Zendesk, you can use the Web Widget (Classic) API by modifying thedocument_head.hbstemplate file in your help center.

First, navigate to Guide and click the Customize design icon. Select the theme you want to edit, open the options menu, and choose Edit Code. In the Templates section, click ondocument_head.hbsto modify the code. Insert your desired code below the first<header class="header">line and above the final header line. For example, to change the widget's position, use the following code:

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

For more detailed instructions, check out theoriginal Zendesk article.


More related questions

What are the steps to edit the document_head.hbs file for Web Widget customization?

Editing thedocument_head.hbsfile is essential for customizing the Web Widget (Classic) in Zendesk. To begin, go to Guide and click on the Customize design icon. Choose the theme you wish to edit and open the options menu to select Edit Code. In…

Can I change the position of the Web Widget (Classic) in Zendesk?

Yes, you can change the position of the Web Widget (Classic) in Zendesk by using the API settings. To adjust the widget's position, modify thedocument_head.hbsfile in your help center. Insert the following code snippet to set the horizontal and…

Is it possible to customize the Web Widget for different brands in Zendesk?

Yes, you can customize the Web Widget for different brands in Zendesk, allowing each brand to have a unique look and feel. To achieve this, you can use the Web Widget (Classic) API to apply different settings for each brand. This includes changing…

What should I do if my theme prevents Web Widget API customizations?

If your theme is preventing Web Widget API customizations, you may need to investigate the JavaScript in your theme. Some themes might have restrictions or conflicts that block API calls. To troubleshoot, try applying your customizations in a…

Interested indeflectingover 70% of your Zendesk support tickets?

Our AI customer support agent is here to help. Trained on all your help docs, installed directly into your Zendesk account, it can be used to automate customer replies for tickets or live chat. Learn more below.
Zendesk logo

Zendesk Support Tickets

Receive new tickets by email or a support form? This integration is for you.
My AskAI integrated within Zendesk to deflect support tickets
Learn about our Zendesk ticket integration
Zendesk logo

Zendesk Messaging (live chat)

Using Zendesk's Messaging widget on your site for live chat? This integration is for you.
My AskAI integrated within Zendesk to deflect customer support live chat conversations
Learn about our Zendesk Messaging integration

Join1,000+ companies reducing their support costs and freeing up support agents for more important work

Vestd company logo — Customer of My AskAI's AI customer support agents
Genesis company logo — Customer of My AskAI's AI customer support agents
Zinc company logo — Customer of My AskAI's AI customer support agents
Customer.io company logo — Customer of My AskAI's AI customer support agents
Zeffy company logo — Customer of My AskAI's AI customer support agents
NHS company logo — Customer of My AskAI's AI customer support agents
Kontakt.io company logo — Customer of My AskAI's AI customer support agents

Reduce support costs.Spend more time on customer success.

Our AI customer support agents are already used by 👇
Companies using AI assistants on their websites