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 plugins

PDF
RSS
Focus mode
Managing Amazon Q Business plugins - Amazon Q Business
Updating a pluginDeleting a pluginGetting plugin propertiesListing pluginsListing configured plugin actionsListing available plugin actionsListing plugin metadata

To manage Amazon Q plugins, you can take the following actions:

Updating a plugin

To update a plugin, you can use AWS Management Console or the UpdatePlugin API operation. The following tabs provide a procedure for the console and code examples for the AWS CLI.

Console

To update a plugin

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

  2. From the Amazon Q console, in Applications, select the name of your application from the list of applications.

  3. From the left navigation menu, choose Actions, and then choose Plugins.

  4. For Plugins, select the plugin that you want to update, and then choose Actions.

  5. For Actions, choose Edit.

    On the plugins configuration page, you can edit your settings.

To deactivate a plugin

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

  2. From the Amazon Q console, in Applications, select the name of your application from the list of applications.

  3. From the left navigation menu, choose Actions, and then choose Plugins.

  4. For Plugins, select the plugin that you want to deactivate, and then choose Actions.

  5. For Actions, choose Deactivate.

    Your plugin will be deactivated. After your plugin is deactivated, its status will change to Inactive.

To reactivate a plugin

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

  2. From the Amazon Q console, in Applications, select the name of your application from the list of applications.

  3. From the left navigation menu, choose Actions, and then choose Plugins.

  4. For Plugins, select the plugin that you want to reactivate, and then choose Actions.

  5. For Actions, choose Reactivate.

    Your plugin will be activated. After your plugin is reactivated, its status will change to Active.

AWS CLI

To edit a plugin


aws qbusiness update-plugin \
--application-id application-id \
--plugin-id plugin-id \
--display-name display-name \
--server-url https://example.atlassian.net \
--auth-configuration basicAuthConfiguration="{secretArn=<secret-arn>,roleArn=<role-arn>}"

To disable a plugin


aws qbusiness update-plugin \
--application-id application-id \
--plugin-id plugin-id \
--state DISABLED

To enable a plugin


aws qbusiness update-plugin \
--application-id application-id \
--plugin-id plugin-id \
--state ENABLED
anchoranchor

To update a plugin

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

  2. From the Amazon Q console, in Applications, select the name of your application from the list of applications.

  3. From the left navigation menu, choose Actions, and then choose Plugins.

  4. For Plugins, select the plugin that you want to update, and then choose Actions.

  5. For Actions, choose Edit.

    On the plugins configuration page, you can edit your settings.

To deactivate a plugin

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

  2. From the Amazon Q console, in Applications, select the name of your application from the list of applications.

  3. From the left navigation menu, choose Actions, and then choose Plugins.

  4. For Plugins, select the plugin that you want to deactivate, and then choose Actions.

  5. For Actions, choose Deactivate.

    Your plugin will be deactivated. After your plugin is deactivated, its status will change to Inactive.

To reactivate a plugin

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

  2. From the Amazon Q console, in Applications, select the name of your application from the list of applications.

  3. From the left navigation menu, choose Actions, and then choose Plugins.

  4. For Plugins, select the plugin that you want to reactivate, and then choose Actions.

  5. For Actions, choose Reactivate.

    Your plugin will be activated. After your plugin is reactivated, its status will change to Active.

Deleting a plugin

To delete a plugin, you can use the AWS Management Console or the DeletePlugin API operation. The following tabs provide a procedure for the console and code examples for the AWS CLI.

Console

To delete a plugin

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

  2. From the Amazon Q console, in Applications, select the name of your application from the list of applications.

  3. From the left navigation menu, choose Actions, and then choose Plugins.

  4. For Plugins, select the plugin that you want to delete, and then choose Actions.

  5. For Actions, choose Delete.

  6. In the dialog box, type delete to confirm your action.

    The console displays a successful deletion message when the plugin deletion process is finished.

AWS CLI

To delete a plugin 


aws qbusiness delete-plugin \
--application-id application-id \
--plugin-id plugin-id
anchoranchor

To delete a plugin

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

  2. From the Amazon Q console, in Applications, select the name of your application from the list of applications.

  3. From the left navigation menu, choose Actions, and then choose Plugins.

  4. For Plugins, select the plugin that you want to delete, and then choose Actions.

  5. For Actions, choose Delete.

  6. In the dialog box, type delete to confirm your action.

    The console displays a successful deletion message when the plugin deletion process is finished.

Getting plugin properties

To get the details of an Amazon Q plugin, you can use either the AWS Management Console or the GetPlugin API operation. The following tabs provide a procedure for the console and code examples for the AWS CLI.

Console

To get plugin details

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

  2. From the Amazon Q console, in Applications, select the name of your application from the list of applications.

  3. From the left navigation menu, choose Actions, and then choose Plugins.

  4. For Plugins, select the configured plugin that you want to see details for.

  5. On the Plugin settings page, the following details are available:

    • Name – The name of your plugin.

    • Type – The type of your plugin.

    • AWS Secrets Manager – The Secrets Manager secret.

    • Creation time – The time stamp for when your plugin was created.

    • Plugin ID – The ID that's assigned to your plugin.

AWS CLI

To get plugin details 


aws qbusiness get-plugin \
--application-id application-id \
--plugin-id plugin-id
anchoranchor

To get plugin details

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

  2. From the Amazon Q console, in Applications, select the name of your application from the list of applications.

  3. From the left navigation menu, choose Actions, and then choose Plugins.

  4. For Plugins, select the configured plugin that you want to see details for.

  5. On the Plugin settings page, the following details are available:

    • Name – The name of your plugin.

    • Type – The type of your plugin.

    • AWS Secrets Manager – The Secrets Manager secret.

    • Creation time – The time stamp for when your plugin was created.

    • Plugin ID – The ID that's assigned to your plugin.

Listing plugins

To list Amazon Q plugins, you can use the AWS Management Console or the ListPlugins API operation. The following tabs provide a procedure for the console and code examples for the AWS CLI.

Console

To list plugins

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

  2. From the Amazon Q console, in Applications, select the name of your application from the list of applications.

  3. From the left navigation menu, choose Actions, and then choose Plugins.

  4. In Plugins, a list of plugins that are attached to your application is available.

AWS CLI

To list plugins 


aws qbusiness list-plugins \
--application-id application-id
anchoranchor

To list plugins

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

  2. From the Amazon Q console, in Applications, select the name of your application from the list of applications.

  3. From the left navigation menu, choose Actions, and then choose Plugins.

  4. In Plugins, a list of plugins that are attached to your application is available.

Listing configured plugin actions

To list actions configured for a specific Amazon Q plugin, you can use the AWS Management Console or the ListPluginActions API operation. The following tabs provide a procedure for the console and code examples for the AWS CLI.

Console

To list specific actions configured for a plugin

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

  2. From the Amazon Q console, in Applications, select the name of your application from the list of applications.

  3. From the left navigation menu, choose Actions, and then choose Plugins.

  4. In Plugins, select your plugin from the list of plugins configured for your application.

  5. On the plugin summary page, you'll find the actions supported by your plugin under Actions supported.

AWS CLI

To list specific actions configured for a plugin 


aws qbusiness list-plugin-actions \
--application-id application-id \
--plugin-id plugin-id
anchoranchor

To list specific actions configured for a plugin

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

  2. From the Amazon Q console, in Applications, select the name of your application from the list of applications.

  3. From the left navigation menu, choose Actions, and then choose Plugins.

  4. In Plugins, select your plugin from the list of plugins configured for your application.

  5. On the plugin summary page, you'll find the actions supported by your plugin under Actions supported.

Listing available plugin actions

To list all available actions for a specific Amazon Q plugin, you can use the AWS Management Console or the ListPluginTypeActions API operation. The following tabs provide a procedure for the console and code examples for the AWS CLI.

Console

To list all available actions for a specific plugin

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

  2. From the Amazon Q console, in Applications, select the name of your application from the list of applications.

  3. From the left navigation menu, choose Actions, and then choose Plugins.

  4. On the Plugins page, under each plugin type, you'll find all the plugins actions supported by Amazon Q Business.

AWS CLI

To list all available actions for a specific plugin


aws qbusiness list-plugin-type-actions \
--plugin-type SERVICE_NOW | SALESFORCE | JIRA | ZENDESK | CUSTOM | QUICKSIGHT | SERVICENOW_NOW_PLATFORM | JIRA_CLOUD | SALESFORCE_CRM | ZENDESK_SUITE | ATLASSIAN_CONFLUENCE | GOOGLE_CALENDAR | MICROSOFT_TEAMS | MICROSOFT_EXCHANGE | PAGERDUTY_ADVANCE | SMARTSHEET | ASANA
anchoranchor

To list all available actions for a specific plugin

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

  2. From the Amazon Q console, in Applications, select the name of your application from the list of applications.

  3. From the left navigation menu, choose Actions, and then choose Plugins.

  4. On the Plugins page, under each plugin type, you'll find all the plugins actions supported by Amazon Q Business.

Listing plugin metadata

To list metadata for a specific Amazon Q plugin, you can use the AWS Management Console or the ListPluginTypeMetadata API operation. The following tabs provide a procedure for the console and code examples for the AWS CLI.

Console

To list metadata for a specific plugin

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

  2. From the Amazon Q console, in Applications, select the name of your application from the list of applications.

  3. From the left navigation menu, choose Actions, and then choose Plugins.

  4. On the Plugins page, under each plugin type, you'll find all the plugin metadata (category, description, and type) supported by Amazon Q Business.

AWS CLI

To list metadata for a specific plugin 


aws qbusiness list-plugin-type-metadata
anchoranchor

To list metadata for a specific plugin

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

  2. From the Amazon Q console, in Applications, select the name of your application from the list of applications.

  3. From the left navigation menu, choose Actions, and then choose Plugins.

  4. On the Plugins page, under each plugin type, you'll find all the plugin metadata (category, description, and type) supported by Amazon Q Business.

On this page

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