Creating a custom lens - AWS Well-Architected Tool

You can use the AWS Well-Architected Tool Connector for Jira to link your Jira account with AWS Well-Architected Tool, and sync improvement items between your workloads and Jira projects.

Creating a custom lens

To create a custom lens
  1. Sign in to the AWS Management Console and open the AWS Well-Architected Tool console at

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


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.