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

Upgrading a lens in AWS WA Tool

Focus mode
Upgrading a lens in AWS WA Tool - AWS Well-Architected Tool

We have released a new version of the Well-Architected Framework. We also added new and updated lenses to the Lens Catalog. Learn more about the changes.

We have released a new version of the Well-Architected Framework. We also added new and updated lenses to the Lens Catalog. Learn more about the changes.

Lenses can be upgraded for workloads and review templates.

Note

You can't undo a lens upgrade. After a workload or review template has been upgraded to the latest lens version, you can't go back to the previous version of the lens.

Upgrading a lens for a workload
  1. On the Notifications page, select a workload to upgrade, and choose Upgrade lens version. Information about what changed in each pillar is displayed.

    Note

    You can also choose View available upgrades from the workload Overview tab.

  2. Before upgrading a lens for a workload, a milestone is created to save the state of your existing workload for future reference. Enter a unique name for the milestone in the Milestone name field.

  3. Select the Confirmation box next to I understand and accept these changes and choose Save.

Once the lens is upgraded, you can view the previous version of the lens from the Milestones tab.

Upgrading a lens for a review template
  1. To upgrade the lens for a review template, choose

  2. On the Notifications page, select a review template to upgrade, and choose Upgrade lens version. Information about what changed in each pillar is displayed.

    Note

    You can also choose View available upgrades from the review template Overview tab.

  3. Select the Confirmation box next to I understand and accept these changes and choose Upgrade and edit template answers to adjust answers to best practice questions for your review template, or Upgrade to upgrade the lens without adjusting your template answers.

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