Adding Web Widget (Classic) to your website or help center

What's my plan?

Suite

Team, Growth, Professional, Enterprise, or Enterprise Plus

Support

Team, Professional, or Enterprise

Quick Look: Admin Center > Channels > Classic > Web Widget

Web Widget (Classic) can be added to any page of your website or to your help center.

Web Widget (Classic) is fully optimized for the mobile experience and does not affect page load times. Web Widget (Classic) is presented in the end user’s language, according to the language setting for end user’s web browser. You can force the widget to always appear in a specific language (see Displaying your widget in a different language).

This article contains the following topics:

• Adding Web Widget (Classic) to your website
• Adding Web Widget (Classic) to your help center

Related articles:

• Using Web Widget (Classic) to embed customer service in your website
• Advanced customization of your Web Widget (Classic)
• Quickstart - Web Widget JavaScript APIs

You cannot use SSO authentication in the Web Widget (Classic) itself. However, you can restrict access by setting up SSO on your help center, or on the website hosting the widget. See Single sign-on options in Zendesk and Using restricted help center content with the Web Widget (Classic).

Adding Web Widget (Classic) to your website

You can add Web Widget (Classic) to any page of your website. After you add the widget code to your website, changes are managed in Zendesk Support and with the Advanced Customization JavaScript APIs, and updates are reflected in the widget wherever it appears.

To add Web Widget (Classic) to your website

1. In Admin Center, click Channels in the sidebar, then select Classic > Web Widget.
2. Click the Installation tab, if it is not already selected.
3. Under the code box, click the Copy code icon.
4. If you want to add the widget to your website, go to the web page where you want to add the widget, then paste the code before the closing HTML </body> tag. Add the code to every web page where you want the widget to appear.
5. Make sure your firewall is configured to allow the Web Widget (Classic) to appear.

If you haven't already, make sure you configure the components in your widget. For information about configuring the Web Widget (Classic) using JavaScript APIs, see the developer docs.

If the Web Widget (Classic) does not appear on pages outside your help center, you most likely have the Require sign in option enabled in your Guide security settings (see Restricting help center access to signed-in end-users).

The Web Widget (Classic) displays help center content that the user is allowed to see. When Require sign in is enabled, and only the help center and Contextual Help toggles are on in your Web Widget (Classic) admin settings, the Web Widget (Classic) will not load for non-authenticated users. If you enabled other options in your Web Widget (Classic) admin settings, such as Contact form, the Web Widget (Classic) does appear.

Adding Web Widget (Classic) to your help center

You can add the Web Widget (Classic) to your help center, so that it appears on every page of your help center.

On some usage plans, you can restrict the pages where the Web Widget (Classic) appears in your help center by using the Web Widget (Classic) API.

To add the Web Widget (Classic) to your help center

1. In Admin Center, click Channels in the sidebar, then select Classic > Web Widget.
2. Click the Installation tab, if it is not already selected.
3. Select the Add to help center checkbox.

   This adds the Web Widget (Classic) to every page of your help center. For more information, see Customizing your help center theme.

   On some usage plans, you can restrict the pages where the Web Widget (Classic) appears in your help center by using the zE.hide() method of the Web Widget (Classic) API. See Advanced Customization of your Web Widget (Classic) and the Web Widget (Classic) API documentation for more information.