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.”

Managing user roles as a channel member in Amazon Q Developer in chat applications

Focus mode
Managing user roles as a channel member in Amazon Q Developer in chat applications - Amazon Q Developer in chat applications

AWS Chatbot is now Amazon Q Developer. Learn more

AWS Chatbot is now Amazon Q Developer. Learn more

Channel members can switch their user roles from their chat channels. Additionally, channel members can unmap user roles from chat client IDs using the Amazon Q Developer in chat applications console.

Adding a user role from a chat channel using Amazon Q Developer

If you are a new channel member or your channel permission approach changes, Amazon Q Developer will prompt you to add a user role.

To add a user role from a chat channel
  1. Choose Let's get started.

  2. Choose an account to add a role.

    Note

    This link will take you directly to the Amazon Q Developer console.

  3. In User role, choose a role.

  4. Choose Save.

    Note

    Choosing Save takes you to an authorization page to fetch your chat client identity. This identity is mapped to your chosen role.

  5. Choose Allow.

Switching user roles from a chat channel using Amazon Q Developer in chat applications

If you find that your current user role doesn’t have the right permissions to achieve your desired task, you can switch roles directly from Microsoft Teams and Slack.

Note

If you are unable to run a particular command after switching roles, contact your administrator regarding the channel guardrails in place.

To switch a user role from a chat channel
  1. In your chat channel, enter @Amazon Q switch-role.

  2. Choose the account that you want to switch roles for.

    Note

    This link will take you directly to the Amazon Q Developer console.

  3. In the Amazon Q Developer console, choose Choose user role.

  4. In User role, choose a user role.

  5. Choose Save.

    Note

    Choosing Save, takes you to an authorization page. This is so your chat client identity can be retrieved and associated with your chosen role.

  6. On the authorization page, choose Allow.

Unmapping a user role using Amazon Q Developer in chat applications

If you have a user role applied that you no longer need, you can unmap it.

To unmap a user role
  1. Open the Amazon Q Developer console.

  2. Choose a configured client.

  3. In User role, choose Clear role.

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