Skip to main content
The assistant answers questions on your Mintlify site. To embed the same capability on another site or web app, use the widget. The widget gives your users access to AI chat trained on your content, wherever they use your product. Embed it in your dashboard, marketing site, support portal, or elsewhere. Add the widget to any website or web application with a hosted script. The widget owns its trigger and renders inside a closed Shadow DOM, an isolated document tree that prevents your application styles from affecting the widget. The only required browser option is your public widget ID. Set embed-specific starter questions and a support email in the browser configuration. The widget uses the deflection contact form from your assistant settings.

​
Prerequisites

​
Enable the widget

You can no longer configure the widget in the dashboard. If you already use the widget, it keeps working on your authorized sites.Email support@mintlify.com if you need help setting up the widget on a new site.

​
Install and configure

Use the playground to configure the presentation, visual options, and observer hooks for your widget. The installation code block updates as you change each option.
Replace YOUR_WIDGET_ID in the generated code with your widget ID.
After you add the generated code to your site, reload the page. Confirm the trigger appears, then click it and send a test question to verify the connection.