---
title: The help widget on your customer’s website
description: "Put a “Help” button on a customer’s website: knowledge base search and request filing without leaving the page, on authorised domains only."
url: "https://illizeo.com/en/centre-aide/help-desk-help-widget/"
updated: "2026-11-20"
category: Help desk
---

# The help widget on your customer’s website

The help widget puts a “Help” button on your customer’s website or web application. Its visitors search the knowledge base for an answer and write to you without leaving the page. The widget follows the same rules as the external portal. This article is for the help desk administrator and for agents.

## Before you start

- You need the **Administer the help center** right (Execute level; Access to read the settings).
- The widget shows the knowledge base’s external articles and the services open to external people, like the portal (see [External portal and incoming e-mail](https://illizeo.com/en/centre-aide/help-desk-external-portal-and-incoming-email/)). With no external service and no external article, the settings page warns that the widget has nothing to show.
- You need the list of domains where the widget will appear (for example *www.lumen-optique.ch*), and someone who can edit the website.

## Setting up the widget

Open **Settings › Help center › Help widget**.

![Help widget settings: display, authorised domains, colour, position, language and button preview](https://i0.wp.com/illizeo.com/wp-content/uploads/2026/11/centre-assistance-widget-01.en_.png?resize=720%2C564&quality=80&ssl=1)
Widget settings

1. In **Authorised domains**, enter one domain per line. **.acme.ch* covers all subdomains, but not *acme.ch* itself: add both if needed.
2. Choose the look: the button’s **Colour**, its **Position** (*Bottom right* or *Bottom left*) and the panel’s **Language** (*The visitor’s*, or a fixed language). The **Button preview** shows the result; the text stays readable on a light colour.
3. Turn on **Show the widget on the authorised domains**, then click **Save**. Without a domain, the widget cannot be turned on.

## Putting the widget on the website

At the top of the page, **Code to paste on the website** gives one line to copy (copy button). The person who manages the website pastes it just before the end of each page where the button should appear. Two optional settings go on that line:

- `data-langue` fixes the panel’s language on that page (fr, en, de or it);
- `data-client` attaches the identifier of the customer signed in to the website to the ticket, for example their customer number.

The website can also open or close the panel from its own code, for example from its own “Contact” link.

## What the visitor sees

![A customer’s website with the widget panel open: search and most read articles](https://i0.wp.com/illizeo.com/wp-content/uploads/2026/11/centre-assistance-widget-02.en_.png?resize=800%2C538&quality=80&ssl=1)
The widget open on the customer’s website

A click on **Help** opens the **How can we help you?** panel:

- the knowledge base search (**Search for an answer…**) and the **Most read articles**; an article opens in the panel;
- **Didn’t find your answer?** then **Contact support** opens the request form;
- **My requests** opens the portal, where the person follows their requests;
- during an outage of a service open to external people, the ongoing incident’s message, with **I am affected**: the form opens prefilled, and the request will follow the incident (see [Major incidents and problems](https://illizeo.com/en/centre-aide/help-desk-major-incidents-and-problems/)).

![Contact support form in the widget panel: address, name, request type, subject, description and attachments](https://i0.wp.com/illizeo.com/wp-content/uploads/2026/11/centre-assistance-widget-03.en_.png?resize=800%2C538&quality=80&ssl=1)
Contacting support from the widget

The form asks for the e-mail address and name, the service (if there are several) and the request type (with the type’s fields), the subject, the description and any attachments. While the subject is being typed, articles that may answer the question are suggested. After **Send**:

- the request is registered and an acknowledgement goes to the address given, with a link to follow it;
- or, if the service requires the address to be confirmed, a confirmation link is sent first: the request is created when it is clicked.

The panel follows the chosen language (French, English, German or Italian) and the dark mode of the visitor’s device. The website’s styles do not change it.

## The ticket on the agent’s side

![Header of a ticket filed through the widget: Website widget channel and information sent by the website](https://i0.wp.com/illizeo.com/wp-content/uploads/2026/11/centre-assistance-widget-04.en_.png?resize=800%2C118&quality=80&ssl=1)
The ticket and what the website sent

A request filed through the widget arrives on the **Website widget** channel. The ticket page shows what the website sent: the page the request came from (link), its title, and the customer identifier marked *declared by the website*.

- This information comes from the website and is never verified: use it as a clue, not as proof of identity.
- Only agents see it; the requester does not. The page is sent without its parameters.
- Reporting and the tickets report count the **Website widget** channel separately.

## Good to know

- Outside the authorised domains, the button does not appear, and the browser refuses to show the panel even if someone copies the code elsewhere. A request sent from another website is refused.
- Turning the widget off removes it from every website, without touching the pasted code: it comes back as soon as you turn it on again.
- The portal’s rules apply here too: services and types open to external people, address confirmation, attachments (at most 5 files, 10 MB each), and a limited number of requests per address and per website.
- When a person is linked to a client organisation, their widget requests are too (see [Client organisations](https://illizeo.com/en/centre-aide/help-desk-client-organisations/)).
- Anonymising a ticket also erases what the website sent. Setting changes are recorded in the help desk log.

### *Similaire*
