Amazon Q Business will no longer be open to new customers starting on July 31, 2026. If you would like to use the service, please sign up prior to July 30. For capabilities similar to Q Business, explore Amazon Quick. Learn more.
Add Amazon Q embedded to your website
You can embed your Amazon Q Business web experience by adding an
<iframe> element to your website with the Deployed
URL or defaultEndpoint you copied earlier as the
src value and a minimum width of 450 pixels as
follows.
<iframe src="Deployed-URL-or-defaultEndpoint" style="min-width: 450px;"/>
Once this <iframe> is added to the website, the Amazon Q Business chat assistant will show up and be ready to be used by your authenticated Amazon Q users.
Amazon Q Business users must provide user authentication credentials before they can use the embedded Amazon Q chat experience on your website. These credentials are the same as the credentials required for the Amazon Q web experience. To authenticate, Amazon Q opens a new browser tab or window where users can enter their credentials. Once successfully authenticated, users can close this tab or window and begin using the embedded Amazon Q chat experience within the website.
Note
-
For anonymous applications, the Deployed URL must be generated every time using the
CreateAnonymousWebExperienceUrlAPI operation. For more information, see Share an anonymous web experience. -
If your browser has a limited cookie mode (ex. Incognito mode in Chrome), you may have to enable third-party cookies for Amazon Q embedded to work.
-
The button for copying may not work without
allow="clipboard-read; clipboard-write"attribute added to iframe