AWS CloudFormation
User Guide (Version )

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.


The AWS::CloudWatch::Dashboard resource specifies an Amazon CloudWatch dashboard. A dashboard is a customizable home page in the CloudWatch console that you can use to monitor your AWS resources in a single view.

All dashboards in your account are global, not region-specific.


To declare this entity in your AWS CloudFormation template, use the following syntax:


{ "Type" : "AWS::CloudWatch::Dashboard", "Properties" : { "DashboardBody" : String, "DashboardName" : String } }


Type: AWS::CloudWatch::Dashboard Properties: DashboardBody: String DashboardName: String



The detailed information about the dashboard in JSON format, including the widgets to include and their location on the dashboard. This parameter is required.

For more information about the syntax, see Dashboard Body Structure and Syntax.

Required: Yes

Type: String

Update requires: No interruption


The name of the dashboard. The name must be between 1 and 255 characters. If you do not specify a name, one will be generated automatically.

Required: No

Type: String

Update requires: Replacement

Return Values


When you pass the logical ID of this resource to the intrinsic Ref function, Ref returns the value of DashboardName.

For more information about using the Ref function, see Ref.

See Also