The Upthread widget is a small floating button that appears on your website. Visitors can search your help articles and submit messages without navigating away from your site.
Enable the widget
Go to Docs then Widget (admin only). Toggle Show the help widget on. Once enabled, the button appears on your help center and any site where you install the snippet below.
Install on your website
Go to Docs then Install and copy the snippet, then paste it into your website's HTML just before the closing </body> tag. That's all, no API keys, no configuration needed.
The snippet loads the widget asynchronously, so it won't slow down your site.
Customize the look
Back on the Widget tab, you can:
- Accent color: change the button and header color (defaults to your workspace brand)
- Position: bottom right or bottom left
- Header title and subtitle: customize the welcome message inside the widget
All changes appear instantly in the live preview.
Features you can toggle
- Contact form: show a "Contact us" tab where visitors can send messages directly to your inbox
- All articles link: add a button that opens your full help center
- Show "Powered by Upthread": show or hide the Upthread attribution at the bottom
Contact form submissions become tickets in your inbox, just like inbound emails.
Public help center
Your published articles are also available at a public URL shown on the Install tab. You can link to this directly or share it in your support emails. The widget appears on the help center too.
Language
The widget automatically matches your visitor's language. It picks the locale in this order:
- Your page's language: the widget reads the lang attribute on your site's <html> tag (for example lang="fr") and matches it.
- A locale you set: add a data-locale attribute to the install snippet to force a specific language.
- Your workspace default: if neither applies, the widget falls back to the default language configured in your workspace.
To pin the widget to one language, add data-locale to the snippet, for example data-locale="fr" for French. Supported languages are English, Français, and العربية (Arabic renders right-to-left).