AWS Well-Architected Tool
User Guide

The AWS Documentation website is getting a new look!
Try it now and let us know what you think. Switch to the new look >>

You can return to the original look by selecting English in the language selector above.

Defining a Workload

The next step is to define a workload.

To define a workload

  1. Sign in to the AWS Management Console and open the AWS Well-Architected Tool console at

  2. If this is your first time using AWS WA Tool, you see a page that introduces you to the features of the service. In the Define a workload section, choose Define workload.

    Alternately, in the left navigation pane, choose Workloads and choose Define workload.

  3. In the Name box, enter a name for your workload.


    The name must be between 3 and 100 characters. At least three characters must not be spaces. Workload names must be unique. Spaces and capitalization are ignored when checking for uniqueness.

  4. In the Description box, enter a description of the workload. The description must be between 3 and 250 characters.

  5. In the Environment box, choose the environment for your workload:

    • Production – Workload runs in a production environment.

    • Pre-production – Workload runs in a pre-production environment.

  6. In the Regions section, choose the Regions for your workload:

    • AWS Regions – Choose the AWS Regions where your workload runs, one at a time.

    • Non-AWS regions – Enter the names of the regions outside of AWS where your workload runs. You can specify up to five unique regions, separated by commas.

    Use both options if appropriate for your workload.

  7. (Optional) In the Account IDs box, enter the IDs of the AWS accounts associated with your workload. You can specify up to 100 unique account IDs, separated by commas.

  8. (Optional) In the Industry type box, choose the type of industry associated with your workload.

  9. (Optional) In the Industry box, choose the industry that best matches your workload.

  10. Choose Define workload.

    If a required box is blank or if a specified value is not valid, you must correct the issue before your workload is defined.