Install and customize the support widget
Add AI chat or a human contact form to your website with the right inbox and branding.
Open Widget and choose the inbox that should receive its conversations. If it doesn’t have a widget yet, a workspace owner or admin can choose an active inbox and select Create widget. The new widget starts disabled while you configure it.
To recover a widget from a deleted inbox, owners and admins can expand Widget availability and recovery and select Review deleted inboxes.
Choose the experience
- AI chat with human handoff lets visitors ask questions and request your team when needed.
- Human contact only opens a contact form without AI chat.
Set the widget name, welcome message where applicable, and accent color. You can upload a JPG, PNG, WebP, or GIF logo/avatar up to 2 MB. Use the preview to check readability and contrast.
Choose a built-in button with a Chat, Help, or Life buoy icon. The button can be a circle or an icon-and-text label.
Allow your site and install the snippet
- Add each allowed origin, such as
https://app.example.com, on its own line. - Use an explicit wildcard such as
https://*.example.comonly when all those subdomains should be allowed. Include the root domain separately if needed. - Save changes, enable Widget availability, and copy the generated Install snippet.
- Add the snippet once to your website’s shared layout or custom-code area.
- Open a page on an allowed origin and test a question or contact submission.
On mobile Safari, the chat and contact fields use 16px text so tapping a field doesn’t zoom the host page. You don’t need to disable pinch-to-zoom on your site.
Allow on any domain deliberately lets any website use the widget. Exact domains are a better fit when the widget is only for your own site.
Open it from your own button
Choose Custom JavaScript trigger and install the normal snippet. After the script has loaded, your application can call:
await OutcomeArc.ready;
await OutcomeArc.open();
Use OutcomeArc.toggle() to toggle it and OutcomeArc.close() to close it. No button appears automatically in custom-trigger mode. You can also use signed identification without opening the panel.
Open an article from your own help button
- In Knowledge, expand a website or sitemap source’s Source health, then select Load page health. Select Preview for the page you want and choose Copy JavaScript trigger. You can preview and copy even if the widget setting is off.
- In Widget settings, choose the inbox, turn on Enable article previews, and save. This is off by default. Enable it only if the website articles available to this inbox are suitable for visitors to read in full.
- Call the copied code from your help button after the widget script loads. It uses the individual page’s ID, not the sitemap’s source ID. The article dialog opens without starting a chat.
The trigger calls window.OutcomeArc.showArticle(articleId). It returns a promise with shown: true once the article loads. Test the trigger on an origin allowed by the widget. The same setting also enables clickable Sources pills for cited website articles in AI replies.
Older imports may show text but not images until the website is synced again. Images are loaded from their original HTTPS URLs, so the site’s Content Security Policy and the image host can affect whether they appear.
If it doesn’t appear
Check the selected inbox, Widget availability, allowed origin including protocol/subdomain, and whether you chose a custom trigger. If your site uses a Content Security Policy, allow the script and connections used by the generated snippet. Install only one widget script on a page.