Level 100: Custom Lenses on AWS Well-Architected Tool


  • Bob Yeh, AWS Well-Architected Geo SA
  • Duncan Bell, AWS Well-Architected Geo SA
  • Ray Wang, Solutions Architect, Analytics SME


Since November 2021, the Well-Architected Tool has included the ability to create custom lenses, which are capable of tailoring a review to a customers specific needs. Within a custom lens, customers can create their own pillars, questions, best practices, helpful resources and improvement plans. Custom lenses can also specify rules which are used to determine if a high or medium risk issues is flagged. Customers can then provide their own guidance for resolving the risk. Custom lenses can be shared across multiple AWS accounts for more visibility.

This lab introduces the AWS Well-Architected Tool’s Custom lenses feature. Using Amazon DynamoDB Configuration Checks as the example, we demonstrate how a self-defined pillar and questions structure can be used for a domain-specific review.


  • Learn how to build custom lenses for domain-specific reviews.
  • Understand the difference between a Well-Architected Framework Review and a Custom Lens Review.


  • An AWS Account that you are able to use for testing, that is not used for production or other purposes.
  • An Identity and Access Management (IAM) user or federated credentials that have permissions to access the AWS Well-Architected Tool with the WellArchitectedConsoleFullAccess managed policy.


Time to complete

  • The lab should take approximately 30 minutes to complete

References & Blogs: