AWS CloudFormation
User Guide (API Version 2010-05-15)


The optional Outputs section declares output values that you want to view from the AWS CloudFormation console or that you want to return in response to describe stack calls. For example, you can output the Amazon S3 bucket name for a stack so that you can easily find it.


During a stack update, you cannot update outputs by themselves. You can update outputs only when you include changes that add, modify, or delete resources.


The Outputs section consists of the key name Outputs, followed by a single colon. Braces enclose all output declarations. If you declare multiple outputs, they are delimited by commas. You can declare a maximum of 60 outputs in an AWS CloudFormation template. The following pseudo template outlines the Outputs section:

"Outputs" : {
  "Logical ID" : {
    "Description" : "Information about the value",
    "Value" : "Value to return"
Logical ID

An identifier for this output. The logical ID must be alphanumeric (A-Za-z0-9) and unique within the template.

Description (optional)

A String type up to 4K in length describing the output value.

Value (required)

The value of the property that is returned by the aws cloudformation describe-stacks command. The value of an output can be literals, parameter references, pseudo parameters, a mapping value, and intrinsic functions.


You can conditionally create an output by associating a condition with it. You must define the condition in the Conditions section of the template.


In the following example, the output named BackupLoadBalancerDNSName returns the DNS name for the resource with the logical ID of BackupLoadBalancer only when the CreateProdResources condition is true. The second output was added to show you how to specify multiple outputs.

"Outputs" : {
  "BackupLoadBalancerDNSName" : {
    "Description": "The DNSName of the backup load balancer",  
    "Value" : { "Fn::GetAtt" : [ "BackupLoadBalancer", "DNSName" ]},
    "Condition" : "CreateProdResources"
  "InstanceID" : {
    "Description": "The Instance ID",  
    "Value" : { "Ref" : "EC2Instance" }