# Enhancing web browsing with Amazon Q Business
Browser extensions

The Amazon Q Business browser extension enhances your users' web browsing experience. As your users browse the web, the Amazon Q Assistant can answer questions, provide summaries, generate content, and complete tasks based on data made available to it or from its general knowledge right in their browser enhancing your users' productivity by bringing Amazon Q's AI-powered assistance directly into their daily workflows.

With the Amazon Q browser extension your users can:
+ Summarize a snapshot of any web page
+ Ask questions about one or more web pages
+ Access Amazon Q's general knowledge and your company's knowledge
+ Upload documents and use other features available in [the Amazon Q web experience](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/using-web-experience.html#upload-documents).

**Topics**
+ [

# Configuring the Amazon Q Business browser extension for use
](configuring-browser-extension.md)
+ [

# Removing the browser extension as an integration
](removing-browser-extension.md)
+ [

# Using the Amazon Q Business browser extension
](using-browser-extension.md)

# Configuring the Amazon Q Business browser extension for use
Configuring

After installation and authentication, your users can access Amazon Q while browsing the web.

**Note**  
Amazon Q does not support users who authenticate using external SAML providers.
The Safari browser is not supported.
Amazon Q Business does not use user data for service improvement or for training its underlying large language models (LLMs). For more information, see [Amazon Q Business Service improvement](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/service-improvement.html).
Upload your documents and have Amazon Q answer contextual questions about them.

**Topics**
+ [

## Prerequisites for integrating the Amazon Q browser extension
](#browser-extensions-prerequisites)
+ [

## Integrating the browser extension with Amazon Q Business
](#integrating-browser-extension)
+ [

## Activating and deploying the browser extension
](#activating-deploying-extension)

## Prerequisites for integrating the Amazon Q browser extension
Prerequisites

As admins, before you can integrate the Amazon Q Business browser extension, you must complete the following steps.

1. [Get started with Amazon Q Business](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/getting-started.html)

1. [Create an IAM Identity Center-integrated application](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/create-application.html) or [Create an IAM federated application environment](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/create-application-iam.html) and create your Amazon Q Business web experience.

1. To use this feature, do the following
   + Enable **Allow end users to send queries directly to the LLM** in your Admin controls and guardrails. For more information, see the [Response settings](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/guardrails-global-controls.html#guardrails-global-response) topic in [Admin controls and guardrails](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/guardrails.html) and [https://docs.aws.amazon.com/amazonq/latest/api-reference/API_ChatSync.html#qbusiness-ChatSync-request-chatMode](https://docs.aws.amazon.com/amazonq/latest/api-reference/API_ChatSync.html#qbusiness-ChatSync-request-chatMode) if you are configuring programmatically.
   + If you are using the IAM Identity Center or OpenID Connect (OIDC) provider in IAM, make sure your IAM role for an Amazon Q Business web experience using IAM Federation is up to date. For more information, see [IAM role for an Amazon Q Business web experience using IAM Federation](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/web-experience-iam-role-iam.html).

## Integrating the browser extension with Amazon Q Business
Integrating

To use the Amazon Q Business browser extension, you must allow it to connect to your Amazon Q Business application environment and web experience. To do this, admins can use the Amazon Q console, API, SDK, or AWS CLI.

**Topics**
+ [

### Using the console
](#integrating-browser-extensions-using-console)
+ [

### Using the AWS API
](#integrating-browser-extensions-browser-extensions-using-aws-api)

### Using the console


1. Sign in to the Amazon Q console.

1. Choose **Applications**, then select the name of your application environment from the list.

1. Choose **Integrations** under **Enhancements**.

1. Choose **Edit** in the **Browser extensions** section on the main page.

1. Choose the **Browser extensions** your want integrate with.

### Using the AWS API


Admin users can enable your browser extensions using the [https://docs.aws.amazon.com/amazonq/latest/api-reference/API_UpdateWebExperience.html](https://docs.aws.amazon.com/amazonq/latest/api-reference/API_UpdateWebExperience.html) and [https://docs.aws.amazon.com/amazonq/latest/api-reference/API_CreateWebExperience.html](https://docs.aws.amazon.com/amazonq/latest/api-reference/API_CreateWebExperience.html) operations.

## Activating and deploying the browser extension
Activating and deploying

After enabling the browser extension, complete these steps to activate and deploy it:

1. Allow-list URLs. If you are using

   1. An OIDC provider like Okta: you must configure your identity provider (IdP) to support browser extension as follows. You will need to consult your provider on how to do this.

      1. Make sure you enable refresh grants

      1. Allow-list the following URLs with the IdP

         1. Mozilla based browsers — `https://ba6e8e6e4fa44c1057cf5f26fba9b2e788dfc34f.extensions.allizom.org`

         1. Chromium based browsers — `https://feihpdljijcgnokhfoibicengfiellbp.chromiumapp.org`

   1. IAM Identity Center, the above is not required and you can move to the next step of installing the browser extension for your users.

1. Install the browser extension for all users using the software deployment processes of your organization. The following is some information about policy settings from the browser vendors using mobile device management (MDM) software that may be helpful:

   1. Firefox policy settings: [https://mozilla.github.io/policy-templates/\$1extensionsettings](https://mozilla.github.io/policy-templates/#extensionsettings)

   1. Chrome policy settings: [https://chromeenterprise.google/policies/\$1ExtensionSettings](https://chromeenterprise.google/policies/#ExtensionSettings)

   1. Edge policy settings: [https://learn.microsoft.com/en-us/DeployEdge/microsoft-edge-policies\$1extensionsettings](https://learn.microsoft.com/en-us/DeployEdge/microsoft-edge-policies#extensionsettings) and guide: [https://learn.microsoft.com/en-us/deployedge/microsoft-edge-manage-extensions-ref-guide](https://learn.microsoft.com/en-us/deployedge/microsoft-edge-manage-extensions-ref-guide)

1. Provide your selected users the browser store URL \$1 Web experience URL so they can download and install the browser extension and connect to Amazon Q.

# Removing the browser extension as an integration
Disabling, removing and blocking

To disable the browser extension to your existing web experience, Admin users can use the Amazon Q Business console or the Amazon Q Business API, AWS SDK, or AWS CLI.

**Topics**
+ [

## Using the console
](#removing-using-console)
+ [

## Using the AWS API
](#removing-browser-extension-using-aws-api)
+ [

## Blocking and removing the browser extension
](#blocking-removing-extension)

## Using the console


1. Sign in to the Amazon Q console.

1. Choose **Applications**, then select the name of your application environment from the list.

1. Choose **Integrations** under **Enhancements**.

1. Choose **Edit** in the **Browser extensions** section on the main page.

1. Deselect the **Browser extensions** you no longer want integrate with.

## Using the AWS API


You can disable browser extensions using the [https://docs.aws.amazon.com/amazonq/latest/api-reference/API_UpdateWebExperience.html](https://docs.aws.amazon.com/amazonq/latest/api-reference/API_UpdateWebExperience.html) API

## Blocking and removing the browser extension
Blocking and removing

Once you disable your browser extension, your users will no longer be able to login. However, you will still need to take steps to uninstall the extension on user's browser via
+ Uninstall the browser extension for all users by updating the policy settings using the mobile device management software (MDM) using one of the following:
  + Firefox policy settings: [https://mozilla.github.io/policy-templates/\$1extensionsettings](https://mozilla.github.io/policy-templates/#extensionsettings)
  + Chrome policy settings: [https://chromeenterprise.google/policies/\$1ExtensionSettings](https://chromeenterprise.google/policies/#ExtensionSettings)
  + Edge policy settings: [https://learn.microsoft.com/en-us/DeployEdge/microsoft-edge-policies\$1extensionsettings](https://learn.microsoft.com/en-us/DeployEdge/microsoft-edge-policies#extensionsettings) and guide: [https://learn.microsoft.com/en-us/deployedge/microsoft-edge-manage-extensions-ref-guide](https://learn.microsoft.com/en-us/deployedge/microsoft-edge-manage-extensions-ref-guide)

# Using the Amazon Q Business browser extension
Using

The browser extension is available to Amazon Q Business users on Google Chrome, Mozilla Firefox, and Microsoft Edge browsers.

**Topics**
+ [

## Prerequisites for using the browser extension
](#user-prerequisites)
+ [

## Install and configure the browser extension
](#install-configure-browser-extension)
+ [

## Common use cases for using the Amazon Q Business browser extension
](#browser-extension-common-use-cases)
+ [

## Considerations for using the Amazon Q Business browser extension
](#browser-extension-considerations)
+ [

## Troubleshooting the Amazon Q Business browser extension
](#browser-extension-troubleshooting)

## Prerequisites for using the browser extension
Prerequisites
+ You must be a user
+ Your Amazon Q Admin must connect the browser extension with your Amazon Q Business web experience.
+ Supported browsers are Google Chrome, Mozilla Firefox, Microsoft Edge, but reach out to their admin to find out which browsers are enabled for use with Amazon Q.

## Install and configure the browser extension

+ To set up your browser extension, either wait for your IT department to configure and install it automatically, or follow their installation instructions.

  The following are browser extensions from third-party providers that may be helpful.
  + Mozilla based browsers — [ https://addons.mozilla.org/en-GB/firefox/addon/amazon-q-business/](https://addons.mozilla.org/en-GB/firefox/addon/amazon-q-business/)
  + Chromium based browsers (including Microsoft Edge) — [ https://chromewebstore.google.com/detail/amazon-q-business/feihpdljijcgnokhfoibicengfiellbp](https://chromewebstore.google.com/detail/amazon-q-business/feihpdljijcgnokhfoibicengfiellbp)
+ If you have an Amazon Q Business web experience and would like to connect to it, navigate to it in one of your other browser windows, the extension will automatically detect and suggest the link to connect your Amazon Q web experience. If not, you will need to paste the link to your Amazon Q web experience at the time of authenticating to the Amazon Q browser extension. Your browser extension will remember this link for future logins, but you can always choose a different Amazon Q web experience link.
+ Once you have successfully logged on, you can use your Amazon Q browser extension.

**Tip**  
You can also *pin* your Amazon Q browser extension to have it readily accessible while using your browser. Instructions for this are specific to your browser of choice. The following third-party information about pinning extensions might be helpful.  
Google Chrome — [https://www.howtogeek.com/683099/how-to-pin-and-unpin-extensions-from-the-chrome-toolbar](https://www.howtogeek.com/683099/how-to-pin-and-unpin-extensions-from-the-chrome-toolbar/)
Mozilla Firefox — [https://support.mozilla.org/en-US/kb/extensions-button\$1w\$1manage-pinned-extensions](https://support.mozilla.org/en-US/kb/extensions-button#w_manage-pinned-extensions)
Microsoft Edge — [https://www.microsoft.com/en-us/edge/features/pin-to-taskbar](https://www.microsoft.com/en-us/edge/features/pin-to-taskbar)

Safari browsers are not supported at the time.

## Common use cases for using the Amazon Q Business browser extension
Use cases

The following are some of the common use cases that will help you make the best use of your Amazon Q Business browser extension:

1. **Summarize a page**

   1. Open the Amazon Q Business browser extension

   1. Login and navigate to the web page that you want to summarize.

   1. Use the **summarize** for a summary of a snapshot of that web page for the moment when you navigated to it.

   1. Now your conversation contains a snapshot of this web page. You can continue to chat about the web page and ask followup questions.

1. **Add web pages and files as context to an Amazon Q conversation**

   1. Switch to General Knowledge mode.

   1. If you have clicked on the summarize button, the current web page is already in your conversation context. To add the current web page to the conversation without summarizing the page:

      1. Choose the paperclip icon

      1. Select add current page

   1. Ask questions about the current web page snapshot.

   1. To add a file, choose the paper clip icon and browse to the file of your choice (\$150MB maximum size limit, \$13.75MB per image)

   1. You can have up to a total of 20 web page snapshots or files in your conversation. To add another web page, navigate to the next web page that you'd like to add and repeat the first step.

   1. To remove an attachment, choose the paper clip icon and remove the web page snapshots or files of your choice.

1. **Access Amazon Q Business’ Knowledge from your company data sources**

   1. Switch to Company Knowledge mode

   1. Ask Q Business questions about your company’s data sources

   1. Get source attribution for your data sources

1. **Reset the context of your current conversation**

   1. To reset the context of your current conversation, choose the new chat bubble icon. Your chat will be free of past attachments and web page snapshots.

**Important**  
The Amazon Q Business browser extension integration does not support [actions or plugins](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/actions.html).

## Considerations for using the Amazon Q Business browser extension
Considerations

1. Amazon Q Business does not use customer data for service improvement or for improving its underlying large language models (LLMs). Also, none of the data you include in your browser extension conversations will be indexed into your company's Amazon Q Business instance. For more information, see [Amazon Q Business Service improvement](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/service-improvement.html).

1. You can access all history of previous conversations (including attachments to those conversations) that have not been deleted from the Amazon Q web experience conversation history.

1. All conversations with Amazon Q including uploaded web page snapshots and files from the browser extension will be deleted after 30 days of inactivity.

1. If you close the Amazon Q browser extension, it will start a new conversation the next time you reopen it.

1. Amazon Q's responses aren't always 100% accurate. For more information, see [Hallucination](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/concepts-terms.html#hallucination) in the topic Key concepts of Amazon Q Business.

## Troubleshooting the Amazon Q Business browser extension
Troubleshooting
+ **My admin has enabled the browser extension, but I'm unable to login.**

  Try having a conversation on your Amazon Q web experience first and then try the browser extension again. If this doesn't work, then contact your Amazon Q admin or IT department.
+ **I am getting a "Can't access document" error.**

  This happens when a web uses an unsupported format from which the browser extension is unable to pull relevant data to provide a helpful response. If you encounter this error and would like your web page to be supported, please submit feedback via the feedback button in the browser extension
+ **Amazon Q doesn't respond helpfully or doesn't use the context of the web page I added.**

  Try starting a new chat and adding the web page snapshot or file again. If it still does not work, submit feedback using the feedback button and include any non-confidential details about the type of web page where the extension failed,
+ **I get the error, 'To use this browser extension, your administrator needs to enable "Allow end users to send queries directly to the LLM" in the Amazon Q Business console'**.

  Contact your Admin or IT department with the error.
+ **Amazon Q doesn't recognize updated information when my web page changes.**

  Amazon Q only has access to a snapshot of a web page. Similar to a photograph, this is all the information in the web page from the time it was uploaded to Amazon Q. To refresh the snapshot of your page, remove the current snapshot of the web page, choose a refreshed snapshot of the page, and choose **Summarize** or **Upload** for summarizing or further contextual analysis.