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

Creating a custom lens for a workload in AWS WA Tool

Focus mode
Creating a custom lens for a workload 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.

To create a custom lens
  1. Sign in to the AWS Management Console and open the AWS Well-Architected Tool console at https://console.aws.amazon.com/wellarchitected/.

  2. In the left navigation pane, choose Custom lenses.

  3. Choose Create custom lens.

  4. Choose Download file to download the JSON template file.

  5. Open the JSON template file with your favorite text editor and add the data for your custom lens. This data includes your pillars, questions, best practices, and improvement plan links.

    Refer to Lens format specification in AWS WA Tool for details. A custom lens cannot exceed 500 KB in size.

  6. Choose Choose file to select your JSON file.

  7. (Optional) In the Tags section, add any tags you want to associate with the custom lens.

  8. Choose Submit & Preview to preview the custom lens, or Submit to submit the custom lens without previewing.

    If you choose to Submit & Preview your custom lens, you can select Next to navigate through the lens preview, or select Exit Preview to go back to Custom lenses.

If validation fails, edit your JSON file and try creating the custom lens again.

After AWS WA Tool validates your JSON file, your custom lens is displayed in Custom lenses.

After a custom lens has been created, it's in DRAFT status. You must publish the lens before it can be applied to workloads or shared with other AWS accounts.

You can create up to 15 custom lenses in an AWS account.

Disclaimer

Do not include or gather personal identifiable information (PII) of end users or other identifiable individuals in or via your custom lenses. If your custom lens or those shared with you and used in your account do include or collect PII you are responsible for: ensuring that the included PII is processed in accordance with applicable law, providing adequate privacy notices, and obtaining necessary consents for processing such data.

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