Add widget to external site

The first step is to configure your future widget. To do so, open HelpDesk site and navigate to the Settings page using the left navbar. Then click on the Widgets button.

Widget Tab

To create a new widget, click on the + New widget configuration button. You can also edit any existing configuration by clicking on the name of the widget. Please note that editing the widget configuration applies to every existing widget with this configuration.

Create a new item

Provide a Title for the widget and choose “For external site” as its Type. If you are creating a widget for an external site, you can choose widget language and whether to allow user registration. Registered users have the ability to review their tickets.

External widget

Check the configuration of the default views. You can set how many Tickets per page the widget will have for a certain view. The Display fields property specifies what information about tickets will be exposed on the widget list. Just start typing the name of a field and pick it up from the dropdown list. Creation of custom views is also available and described in this article.

To include private comments from a ticket to the widget view activate the option Include private comments.

Edit widget view


Display fields customization is available from version 1.4.7 and custom views—from version 2.1.9.


Display fields are cached for 30 minutes for optimisation purposes. You will need to clear browser cache to apply your changes immediately.

After saving, copy the generated HTML snippet for external sites.

Copy HTML snippet

Open editing form of your HTML page and add the copied snippet where you’d like to place the widget.