Document history for Amazon Q Developer User Guide
The following table describes the document history for the Amazon Q Developer User Guide. For notifications about updates to this documentation, you can subscribe to the RSS feed.
| Change | Description | Date |
|---|---|---|
Updated the profile sharing section | The Enabling profile sharing section incorrectly indicated that the profile settings in the management account would override those in member accounts when profile sharing was enabled. This statement has been removed, and the purpose of profile sharing has been clarified. | July 2, 2025 |
Added slash commands details to Amazon Q Developer for GitHub content | Amazon Q Developer for GitHub can be invoked with slash commands to perform feature development, code reviews, and code transformation, as well invoke for help, which provides a link to to the Amazon Q Developer for GitHub content. | June 30, 2025 |
Updated details for QCT CLI in IDEs | Added details about maintaining security, pausing or canceling code transformation, new
parameter for | June 26, 2025 |
New content for creating project rules in third-party platforms | You can create project rules in GitLab and GitHub for standards and best practices. | June 26, 2025 |
Updated KMS policy for third-party integration | Added | June 25, 2025 |
Added proxy configuration instructions | Added a Configuring a corporate proxy in Amazon Q for Visual Studio Code section. | June 25, 2025 |
Updated user activity reports | User activity reports are now generated at midnight UTC, and broken into several files with 1,000 users in each. | June 24, 2025 |
Updated the Amazon S3 bucket section | Updated the Amazon S3 bucket URLs and ARNs to allowlist section to indicate version 1.72.0 and later of the Visual Studio Code plugin for Amazon Q does not require allowlisting of buckets. | June 24, 2025 |
Rebranded Amazon Q Developer operational investigations | Updated various sections to reflect the rebranding of Amazon Q Developer operational investigations to CloudWatch investigations. | June 24, 2025 |
Updated GitHub feature development and code transformation details | Amazon Q Developer for GitHub can now be invoked to perform feature development and transform code using slash commands in comments within an issue. | June 19, 2025 |
Rules button added to VS Code IDE chat | Added Rules button to the chat interface for creating and managing project rules through the UI. | June 18, 2025 |
Pinned context support added to VS Code IDE chat | Added context pinning functionality in VS Code to maintain selected context items across chat interactions, with support for manual pinning and system-added context management. | June 18, 2025 |
Updated details for code transformation in IDEs | Added code transformation details about source code version and target code version, and additional transformation requirements to upgrade project libraries and dependencies. Removed details about multiple diffs. | June 17, 2025 |
Chat with Amazon Q about network security | You can chat about network security with Amazon Q in the console and in chat applications. | June 17, 2025 |
Added new Data storage topic | Added the Data storage in Amazon Q Developer topic with information about where content is stored. | June 13, 2025 |
MCP in the IDE | MCP servers can now be used with Amazon Q Developer in the IDE. | June 12, 2025 |
Personal account (Builder ID) upgrade | Users with personal accounts (Builder IDs) can now upgrade to the Pro tier. | June 11, 2025 |
Updates to subscription statuses | Updated the description of the Unavailable subscription status in Amazon Q Developer subscription statuses. | June 9, 2025 |
Support for specifying dependencies for transformations on the CLI | You can provide a dependency upgrade file and modify the transformation plan for Java upgrades with the command line tool for transformations. | June 9, 2025 |
Expanded command line reference | A new command reference section provides more information on the arguments you can use to invoke the Q CLI. | June 9, 2025 |
Model selection for chat on the command line | You can now select the model you want Amazon Q to use for chat sessions on the command line. | June 5, 2025 |
Chat context support expanded to JetBrains, Visual Studio, and Eclipse IDEs | Amazon Q now supports contexts in the JetBrains, Visual Studio, and Eclipse IDE chat panel. | June 5, 2025 |
Agentic chat in all supported IDEs | Agentic chat is available in all supported IDEs. | June 5, 2025 |
Updated GitHub code review details |
Amazon Q Developer for GitHub can now perform code reviews within GitHub pull requests. They
can be initiated with the | June 2, 2025 |
Cost optimization capabilities in chat | In addition to cost analysis, you can chat with Amazon Q to get AWS cost optimization insights. | June 2, 2025 |
Updated the firewall page | Updated and added URLs on the Configuring a firewall, proxy server, or data perimeter for Amazon Q Developer Pro page. | May 22, 2025 |
MCP configuration commands | Commands that you can give directly from your non-Q command line to configure MCP servers for Amazon Q. | May 21, 2025 |
Updated the customization policy topic | The Allow administrators to create customizations topic now describes permission errors that may occur when you create the customization policy. | May 16, 2025 |
Updated troubleshooting tasks | The Troubleshooting Amazon Q Developer Pro subscriptions topic now includes more information. | May 15, 2025 |
Updated new code review behavior for GitLab Duo and GitHub | Automatic code reviews have been updated so they are triggered in new or reopened GitLab merge requests and GitHub pull requests. Code reviews are not triggered by subsequent commits. | May 15, 2025 |
Updated VPC endpoints | Updated the VPC endpoints on the Amazon Q Developer and interface endpoints (AWS PrivateLink) page. | May 15, 2025 |
Improved MCP server loading | MCP servers now load in the background, allowing you to start interacting with Amazon Q immediately without waiting for all servers to initialize. | May 15, 2025 |
Added image support in chat | Amazon Q can now analyze and discuss images directly in your chat session using the
| May 15, 2025 |
Added conversation persistence | Amazon Q automatically remembers your conversations based on the directory where they take
place, and provides | May 15, 2025 |
Updated managed policies: AmazonQFullAccess and AmazonQDeveloperAccess | Additional permissions have been added to the AmazonQFullAccess policy and AmazonQDeveloperAccess policy to manage conversation history. | May 14, 2025 |
Support for multiple conversations in console chat | You can save and switch between conversations with Amazon Q in the AWS console. | May 14, 2025 |
Added subscription details | The Subscribe users to Amazon Q Developer Pro across accounts topic now includes information about where to install IAM Identity Center and the Amazon Q Developer profile. | May 13, 2025 |
Transformation website removed | The Amazon Q Developer transformation website has been taken down, and with it, the related documentation. | May 12, 2025 |
Updated terminology | Updated the term identity-aware console sessions to identity-enhanced console sessions throughout this guide. | May 10, 2025 |
Example SCP added | This service control policy (SCP) denies access to Amazon Q outside of EU regions. | May 8, 2025 |
Amazon Q Developer for GitHub | Information about Amazon Q Developer for GitHub, including concepts and procedures focused on setting up, key features, and configuration. | May 5, 2025 |
Added context hooks | Added support for context hooks. | May 3, 2025 |
Managed policy updated | Permission has been added to AmazonQFullAccess. | May 2, 2025 |
Agentic chat in the IDE | Agentic chat functionality is available in the IDE. | May 1, 2025 |
Updates to customizations | Customizations now support additional languages. | April 30, 2025 |
Managed and example policies update | Permissions have been added to AmazonQFullAccess, GitLabDuoWithAmazonQPermissionsPolicy, and Allow administrators to configure plugins. | April 30, 2025 |
Added MCP support | Added support for MCP in the CLI. | April 29, 2025 |
Added upgrade details | Added information about how to upgrade from the Free tier to the Pro tier. | April 28, 2025 |
Support for conversation history | Your conversation history is now saved when you chat with Amazon Q in the IDE. | April 21, 2025 |
Support for code as context | You can now specify classes, functions, and global variables as context when you chat with Amazon Q in the IDE. | April 21, 2025 |
Updates to GitLab Duo with Amazon Q onboarding and policy | GitLab Duo with Amazon Q has been updated with changes to onboarding and permissions policy ( GitLabDuoWithAmazonQPermissionsPolicy). | April 16, 2025 |
Updated dashboard permissions | Updated the list of permissions required to view the Amazon Q Developer dashboard. | April 15, 2025 |
Improved security documentation for command line | Reorganized and enhanced security documentation with comprehensive guidance on security considerations, best practices, and safe usage of tool permissions. | April 13, 2025 |
Enhanced command-line security and settings | Added a new command-line settings section with configuration options. Enhanced tool permissions documentation with security best practices for sensitive environments. | April 12, 2025 |
Update to the subscription experience | The workflow to subscribe users to Amazon Q Developer Pro and install the Amazon Q Developer profile has been moved from the Amazon Q console to the Amazon Q Developer console. | April 10, 2025 |
Inline chat is available in Eclipse | You can chat inline with Amazon Q in Eclipse. | April 10, 2025 |
Amazon Q Developer profiles are available in Europe (Frankfurt) | When you subscribe to Amazon Q Developer, you can create profiles in the Europe (Frankfurt) Region. | April 10, 2025 |
/tools feature added to CLI | You can use the
| April 10, 2025 |
Support for natural languages other than English | You can chat with Amazon Q in the IDE and on the command line. | April 9, 2025 |
Updates to GitLab Duo with Amazon Q |
GitLab Duo with Amazon Q has been updated regarding changes to inline policy, and you can
optionally create a CMK policy. The | April 8, 2025 |
Email notifications for transformations | You may receive email notifications for updates related to your transformations. | April 8, 2025 |
New context, prompt, and project rules topics | The Adding context to the chat, Saving prompts, and Creating project rules topics have been added. | April 4, 2025 |
Updates to subscriptions topics | The Understanding subscriptions, Viewing aggregated subscriptions, and Enabling profile sharing topics have been corrected. | March 25, 2025 |
Example policy update | The example policies in Allow administrators to use the Amazon Q console and Allow administrators to use the Amazon Q Developer console have been updated with the
| March 24, 2025 |
Support for C++ and C# in customizations | Customizations now support C++ and C#. | March 20, 2025 |
Updates to chatting about resources | You can chat with Amazon Q about multiple AWS resources and services to get answers about your AWS infrastructure and configurations. | March 13, 2025 |
Additional language support for documentation generation | The agent for documentation generation now supports C++ and C#. | March 12, 2025 |
New subscription-related limit | Updated the Subscribing users to Amazon Q Developer Pro topic to indicate that you can enable Amazon Q Developer in a maximum of 50 AWS accounts within an organization managed by AWS Organizations. | March 6, 2025 |
Context integration to CLI chat | Amazon Q CLI now has context integration, giving Amazon Q enhanced understanding of use cases and enabling it to provide more relevant and context-aware responses. | March 6, 2025 |
Policy correction | A JSON sytax error has been corrected in the policy described in Allow administrators to use the Amazon Q console. | February 28, 2025 |
New version of the command line tool for transformation | The latest version of the command line tool for transformation includes support for authenticating with IAM through the AWS CLI. | February 28, 2025 |
Upgrading to the Pro tier | Added information about how to upgrade to the Pro tier in the Amazon Q Developer Free tier topic. | February 25, 2025 |
Customizations policy update | A permission has been added to the customizations policy. | February 25, 2025 |
New dashboard topic | The following topic has been added: Descriptions of Amazon Q Developer dashboard usage metrics. | February 21, 2025 |
New cross-region processing topic | The cross-region processing topic describes how Amazon Q Developer processes requests and makes calls across AWS Regions to provide the service. | February 21, 2025 |
Managed policy update | Permissions have been added to AWSServiceRoleForUserSubscriptions. | February 21, 2025 |
/doc enhancement | Amazon Q can now generate infrastructure
diagrams in response to a | February 20, 2025 |
New subscription topics | Two subscription-related topics were added: Amazon Q Developer subscription statuses and Viewing aggregated Amazon Q Developer subscriptions. | February 19, 2025 |
Amazon Q Developer in chat applications chapter | Amazon Q Developer in chat applications is now Amazon Q Developer in chat applications. A new chapter describes the supported features. | February 19, 2025 |
Support for Java 21 transformations | You can upgrade Java applications to Java 21 in the IDE and on the command line. | February 14, 2025 |
New firewall topic | A Configuring a firewall or proxy server for Amazon Q Developer topic has been added. | February 14, 2025 |
New version of the command line tool for transformation | The latest version of the command line tool for transformation includes support for converting embedded SQL in Java applications. | February 12, 2025 |
User activity report correction | The path to the user activity report CSV file has been corrected. | February 10, 2025 |
Update to the retention period of transformed code | Amazon Q now retains transformed code for 30 days, up from 24 hours. | February 7, 2025 |
New subscription workflow | The steps to subscribe users to Amazon Q Developer have been improved. | February 6, 2025 |
New version of the command line tool for transformation | The latest version of the command line for transformation includes the ability to receive your upgraded Java code in multiple commits. | February 3, 2025 |
/dev enhancement | Amazon Q can now test
the code it generates in response to a | January 31, 2025 |
Customizations section update | The Creating your customization topic now indicates you can include any number of repositories in your customization. | January 24, 2025 |
Prompt logging examples | The Enabling prompt logging section now includes example logs. | January 23, 2025 |
CloudZero plugin | The CloudZero plugin is available in Amazon Q chat. | January 15, 2025 |
User activity report update | New metrics have been added to User activity reports. | December 16, 2024 |
Dashboard update | Information about the old dashboard has been removed from the Amazon Q Developer Pro dashboard section. Information about filters and metrics has been added. | December 16, 2024 |
Troubleshooting with Amazon Q | An Asking Amazon Q to troubleshoot your resources section has been added. | December 13, 2024 |
Identity-enhanced sessions update | The instructions for enabling identity-enhanced console sessions have been clarified in the Subscribing users to the Amazon Q Developer Pro tier with an organization instance section. | December 6, 2024 |
New test generation agent | You can use Amazon Q test generation feature to generate unit tests. | December 3, 2024 |
Large-scale transformation | Amazon Q can transform .NET, mainframe, and VMware workloads in bulk. | December 3, 2024 |
GitLab Duo with Amazon Q | Information about GitLab Duo with Amazon Q, including concepts, getting started procedures, and troublehsooting. | December 3, 2024 |
Documentation generation in the IDE | Amazon Q can generate READMEs for your code in supported IDEs. | December 3, 2024 |
Code reviews in the IDE | Amazon Q code reviews, previously security scans, can detect and address issues in your code in supported IDEs. | December 3, 2024 |
.NET transformation in the IDE | Amazon Q can port your .NET applications to Linux-compatible cross-platform applications in Visual Studio, available in preview. | December 3, 2024 |
Transformation on the command line | You can transform Java applications on the command line, available in preview. | November 27, 2024 |
Multiple diffs for transformation in the IDE | You can choose to receive transformation changes from Amazon Q in multiple diffs. | November 27, 2024 |
Amazon Q in Eclipse | The Amazon Q plugin is available in preview in Eclipse. | November 27, 2024 |
Cost analysis | The cost analysis capability, previously available in preview, is now generally available. | November 26, 2024 |
Transformation for embedded SQL code | You can convert embedded SQL code in your Java applications with Amazon Q transformation in the IDE. | November 22, 2024 |
Dashboard update | The Amazon Q Developer Pro dashboard has been update with new metrics. | November 22, 2024 |
CodeConnections repositories | When creating a customization using a CodeConnections connection, you can now choose the repositories you want to use. | November 22, 2024 |
Amazon Q command line now supports Linux | Amazon Q command line supports Linux environments. It supports Ubuntu 22 and 24, and may otherwise work with GNOME v42+ or environments where the display server is Xorg and the input method framework is IBus. | November 21, 2024 |
Subscribing users | The instructions for subscribing users in Setting up access to the Amazon Q Developer Pro tier have been updated to reflect new user interface (UI) elements. | November 20, 2024 |
Changes to customizations | The Customization in chat feature is now generally available. Also, customizations can
now be created with the following file types: | November 20, 2024 |
Supported IAM Identity Center Regions | A section has been added with information about the Regions where you can set up IAM Identity Center instances for Amazon Q Developer Pro subscriptions. | November 18, 2024 |
Languages added | Support has been added for Dart, Lua, R, Swift, SystemVerilog, and Powershell, as well as expanded support for JSON and YAML. | November 18, 2024 |
Customer managed key support | Information about using customer managed keys and the features that can be encrypted with them has been added to the Data encryption topic. | November 18, 2024 |
Cross-region inference | A topic on cross-region inference in Amazon Q Developer has been added. | November 18, 2024 |
Amazon Q Developer Pro quotas | A Pro tier quotas section has been added. | November 18, 2024 |
Updated managed policy: AmazonQFullAccess | Additional permissions have been added to the AmazonQFullAccess policy. | November 13, 2024 |
Updated managed policy: AmazonQDeveloperAccess | Additional permissions have been added to the AmazonQDeveloperAccess policy. | November 13, 2024 |
Amazon Q plugins | Plugins enable users to chat with Amazon Q about metrics provided by third party tools. | November 13, 2024 |
User activity reports | You can now enable user activity reports. | November 8, 2024 |
Customizations section update | The Preparing your data section now describes file and directory naming limitations. | November 5, 2024 |
Clarified the Amazon Q Developer Pro section | The instructions for subscribing users to Amazon Q Developer Pro have been clarified. | November 1, 2024 |
Inline chat | You can transform code using the new inline chat feature. | October 29, 2024 |
Updated managed policies: AmazonQFullAccess and AmazonQDeveloperAccess | Additional permissions have been added to the AmazonQFullAccess policy and AmazonQDeveloperAccess policy. | October 28, 2024 |
Customizations section correction | The Creating your customization section now indicates that your codebase must reside in a folder in Amazon S3, not the bucket's root. | October 28, 2024 |
Prompt logging section clarification | The Enabling prompt logging section's wording was clarified. | October 24, 2024 |
Amazon S3 bucket policy fix | The Amazon S3 bucket policy shown in Enabling prompt logging contained a JSON syntax error that was fixed. | October 22, 2024 |
Expanded features chapter | The chapter describing various Amazon Q Developer features has been significantly expanded. | October 3, 2024 |
Console-to-Code | Console-to-Code, previously available in preview as a feature of Amazon EC2, is now generally available as a feature of Amazon Q Developer. It integrates with Amazon EC2, Amazon VPC, and Amazon RDS. | October 3, 2024 |
New policy: Use Amazon Q CLI with AWS CloudShell | Identity-based policy allows users to use Amazon Q CLI with AWS CloudShell. | October 2, 2024 |
Prompt logging | You can log your users' IDE prompts in an Amazon S3 bucket. | September 16, 2024 |
Setup content updated | The Getting started chapter has been significantly simplified and restructured. | August 15, 2024 |
CodeWhisperer endpoint needed for IDE VPC access |
Access
from a Amazon VPC must include both | July 18, 2024 |
New endpoint | Endpoints can now use the
string | July 12, 2024 |
Customizations are GA | The customizations feature is generally available. | July 10, 2024 |
Chatting about customizations (Preview) | In Preview, you can use the customizations feature to ask questions related to your codebase. | July 10, 2024 |
Updated managed policy: AmazonQFullAccess | Additional permissions have been added to the AmazonQFullAccess policy. | July 9, 2024 |
New managed policy: AmazonQDeveloperAccess | The AmazonQDeveloperAccess managed policy provides full access to enable interactions with Amazon Q Developer, without administrator access. | July 9, 2024 |
Updated Amazon Q Developer admin policy | June 19, 2024 | |
Trusted access section | A new section more clearly explains how a Amazon Q Developer administrator can share settings with member accounts. | June 19, 2024 |
Updated setup procedures | There's an improved Getting started chapter that includes support for account instances. | June 6, 2024 |
Updated code examples | The code examples now include C and C++, and have improved examples for C#. | June 6, 2024 |
Updated managed policy: AmazonQFullAccess | Additional permissions have been added to the AmazonQFullAccess policy. | April 30, 2024 |
New service-linked role: AWSServiceRoleForUserSubscriptions | The AWSServiceRoleForUserSubscriptions service-linked role provides access for User Subscriptions to your IAM Identity Center resources to automatically update your subscriptions. | April 30, 2024 |
New service-linked role: AWSServiceRoleForAmazonQDeveloper | The AWSServiceRoleForAmazonQDeveloper service-linked role grants permission to access and emit data, and to create reports. | April 30, 2024 |
New managed policy: AWSServiceRoleForUserSubscriptionPolicy | The AWSServiceRoleForUserSubscriptionPolicy allows principals to track IAM Identity Center directory and AWS Organizations changes. | April 30, 2024 |
New managed policy: AWSServiceRoleForAmazonQDeveloperPolicy | The AWSServiceRoleForAmazonQDeveloperPolicy allows Amazon Q Developer to call CloudWatch and CodeGuru on your behalf. | April 30, 2024 |
GA release | Amazon Q Developer is available for general audiences. | April 30, 2024 |
Amazon CodeWhisperer merge | Amazon CodeWhisperer is now a part of Amazon Q Developer. | April 30, 2024 |
New guide name | This service and accompanying user guide have been renamed Amazon Q Developer. | March 29, 2024 |
New permission | The ListConversations action is required to chat with Amazon Q in the console. | March 5, 2024 |
New data protection topic | Amazon Q now uses content for service improvement purposes. | January 25, 2024 |
New topic | Added instructions for how to add Amazon Q to Slack and Microsoft Teams channels that are configured with Amazon Q Developer in chat applications. | January 18, 2024 |
Preview release | This is the initial preview release of the Amazon Q Developer User Guide. | November 28, 2023 |
