Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

Preferences
Contact Us
Feedback
AWS Documentation
Create an AWS Account

Managing Amazon Q Business web experiences

PDF
RSS
Focus mode
Managing Amazon Q Business web experiences - Amazon Q Business
Creating a web experienceDeleting a web experienceGetting properties of a web experience Listing web experiencesUpdating a web experience

To manage Amazon Q Business web experiences, you can take the following actions:

Creating a web experience

To create an Amazon Q Business web experience, you can use the console or the CreateWebExperience API operation.

The following tabs provide a procedure for the AWS Management Console and code examples for the AWS CLI.

Console

If you use the console, this action is spread across two steps: Configuring an Amazon Q Business application using AWS IAM Identity Center and Customizing web experience. To create a web experience, you must create an application environment.

AWS CLI

To create an Amazon Q Business web experience


aws qbusiness create-web-experience \
--application-id application-id \ 
--sample-prompts-control-mode sample-prompts \      
--subtitle subtitle \     
--tags tags \ 
--title title \
--welcome-message welcome-message \
anchoranchor

If you use the console, this action is spread across two steps: Configuring an Amazon Q Business application using AWS IAM Identity Center and Customizing web experience. To create a web experience, you must create an application environment.

Deleting a web experience

To delete an Amazon Q Business web experience, you can use the console or the DeleteWebExperience API operation.

If you're using the API, you can delete a web experience without deleting the application environment that it's a part of.

If you're using the console, the only way to delete your Amazon Q Business web experience is to delete the Amazon Q Business application environment that it's attached to.

The following tabs provide a procedure for the AWS Management Console and code examples for the AWS CLI.

Console

To delete an Amazon Q Business web experience

  1. Sign in to the AWS Management Console and open the Amazon Q Business console.

  2. In Applications, choose Actions.

  3. Choose Delete.

  4. In the dialog box that opens, type Delete to confirm deletion, and then choose Delete.

    You are returned to the service console while your application environment is deleted. When the deletion process is complete, the console displays a message confirming successful deletion. Both the application environment and the web experience are deleted.

AWS CLI

To delete an Amazon Q Business web experience


aws qbusiness delete-web-experience \
--application-id application-id \
--web-experience-id web-experience-id
anchoranchor

To delete an Amazon Q Business web experience

  1. Sign in to the AWS Management Console and open the Amazon Q Business console.

  2. In Applications, choose Actions.

  3. Choose Delete.

  4. In the dialog box that opens, type Delete to confirm deletion, and then choose Delete.

    You are returned to the service console while your application environment is deleted. When the deletion process is complete, the console displays a message confirming successful deletion. Both the application environment and the web experience are deleted.

Getting properties of a web experience

To get the properties of an Amazon Q Business web experience, you can use the console or the GetWebExperience API operation.

The following tabs provide a procedure for the AWS Management Console and code examples for the AWS CLI.

Console

To get properties of an Amazon Q Business web experience

  1. Sign in to the AWS Management Console and open the Amazon Q Business console.

  2. In Applications, select the name of your application environment from the list of applications.

  3. For Web experience settings, the following settings are available:

    • Web experience IAM role ARN – The IAM role assumed by end users when they log in to your web experience.

    • Deployed URL – The deployed URL of your web experience.

    • Tags – Tags that are attached to your web experience.

    To update a setting, choose Edit.

AWS CLI

To get properties of an Amazon Q Business web experience


aws qbusiness get-web-experience \
--application-id application-id \
--web-experience-id web-experience-id
anchoranchor

To get properties of an Amazon Q Business web experience

  1. Sign in to the AWS Management Console and open the Amazon Q Business console.

  2. In Applications, select the name of your application environment from the list of applications.

  3. For Web experience settings, the following settings are available:

    • Web experience IAM role ARN – The IAM role assumed by end users when they log in to your web experience.

    • Deployed URL – The deployed URL of your web experience.

    • Tags – Tags that are attached to your web experience.

    To update a setting, choose Edit.

Listing web experiences

To list Amazon Q Business web experiences, you can use the console or the ListWebExperiences API operation.

If you use the console, you can only see the web experience that's attached to a single application environment.

The following tabs provide a procedure for the AWS Management Console and code examples for the AWS CLI.

Console

To list Amazon Q Business web experiences

  1. Sign in to the AWS Management Console and open the Amazon Q Business console.

  2. For Applications, the Amazon Q Business web experience attached to your application environment is shown.

AWS CLI

To list Amazon Q Business web experiences


aws qbusiness get-web-experience \
--application-id application-id \
--web-experience-id web-experience-id \
--max-results max-results-to-return
anchoranchor

To list Amazon Q Business web experiences

  1. Sign in to the AWS Management Console and open the Amazon Q Business console.

  2. For Applications, the Amazon Q Business web experience attached to your application environment is shown.

Updating a web experience

To update an Amazon Q Business web experience, you can use the console or the UpdateWebExperience API operation.

The following tabs provide a procedure for the AWS Management Console and code examples for the AWS CLI.

Console

To update an Amazon Q Business web experience

  1. Sign in to the AWS Management Console and open the Amazon Q Business console.

  2. In Applications, select the name of your application environment from the list of applications.

  3. Select Customize web experience.

  4. Expand the right navigation menu to edit your web experience settings.

AWS CLI

To update an Amazon Q Business web experience


aws qbusiness update-web-experience \
--application-id application-id \
--web-experience-id web-experience-id \
--authentication-configuration authentication-configuration \  
--sample-prompts-control-mode sample-prompts \      
--subtitle subtitle \     
--title title \
--welcome-message welcome-message
anchoranchor

To update an Amazon Q Business web experience

  1. Sign in to the AWS Management Console and open the Amazon Q Business console.

  2. In Applications, select the name of your application environment from the list of applications.

  3. Select Customize web experience.

  4. Expand the right navigation menu to edit your web experience settings.

On this page

PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.