[ AWS CLI Command Reference ](../../index.html)

  * [ Home ](../../index.html)
  * [ User Guide ](https://docs.aws.amazon.com/cli/latest/userguide/)
  * [ Forum ](https://forums.aws.amazon.com/forum.jspa?forumID=150)
  * [ GitHub ](https://github.com/aws/aws-cli)

###  Navigation

  * [ index ](../../genindex.html "General Index")
  * [ next ](list-resource-scan-related-resources.html "list-resource-scan-related-resources") | 
  * [ previous ](list-generated-templates.html "list-generated-templates") | 
  * [ AWS CLI 2.15.40 Command Reference ](../../index.html) » 
  * [ aws ](../index.html) » 
  * [ cloudformation ](index.html) » 

  * [ ← list-generated-templates ](list-generated-templates.html "previous chapter \(use the left arrow\)") / 
  * [ list-resource-scan-related-resources → ](list-resource-scan-related-resources.html "next chapter \(use the right arrow\)")

[ ![Amazon Web Services logo](../../_static/logo.png) ](../../index.html)

###  [ Table of Contents ](../../index.html)

  * list-imports 
    * Description 
    * Synopsis 
    * Options 
    * Global Options 
    * Examples 
    * Output 

###  Quick search

Search box  Search

###  Feedback

Did you find this page useful? Do you have a suggestion to improve the
documentation? [ Give us feedback ](https://docs.aws.amazon.com/forms/aws-doc-
feedback?hidden_service_name=AWS%20Command%20Line%20Interface&hidden_guide_name=Reference&topic_url=https%3A%2F%2Fdocs.aws.amazon.com%2Fcli%2Flatest%2Freference/cloudformation/list-
imports.html) .  
If you would like to suggest an improvement or fix for the AWS CLI, check out
our [ contributing guide ](https://github.com/aws/aws-
cli/blob/develop/CONTRIBUTING.md) on GitHub.

###  User Guide

First time using the AWS CLI? See the [ User Guide
](https://docs.aws.amazon.com/cli/latest/userguide/) for help getting started.

[ [ aws  ](../index.html#cli-aws) . [ cloudformation  ](index.html#cli-aws-
cloudformation) ]

#  list-imports  Â¶

##  Description  Â¶

Lists all stacks that are importing an exported output value. To modify or
remove an exported output value, first use this action to see which stacks are
using it. To see the exported output values in your account, see ListExports .

For more information about importing an exported output value, see the [
Fn::ImportValue
](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-
function-reference-importvalue.html) function.

See also: [ AWS API Documentation
](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListImports)

` list-imports  ` is a paginated operation. Multiple API calls may be issued
in order to retrieve the entire data set of results. You can disable
pagination by providing the ` --no-paginate  ` argument. When using ` --output
text  ` and the ` --query  ` argument on a paginated response, the ` --query
` argument must extract data from the results of the following query
expressions: ` Imports  `

##  Synopsis  Â¶

    
    
      list-imports
    --export-name <value>
    [--cli-input-json | --cli-input-yaml]
    [--starting-token <value>]
    [--max-items <value>]
    [--generate-cli-skeleton <value>]
    [--debug]
    [--endpoint-url <value>]
    [--no-verify-ssl]
    [--no-paginate]
    [--output <value>]
    [--query <value>]
    [--profile <value>]
    [--region <value>]
    [--version <value>]
    [--color <value>]
    [--no-sign-request]
    [--ca-bundle <value>]
    [--cli-read-timeout <value>]
    [--cli-connect-timeout <value>]
    [--cli-binary-format <value>]
    [--no-cli-pager]
    [--cli-auto-prompt]
    [--no-cli-auto-prompt]
    

##  Options  Â¶

` --export-name  ` (string)

> The name of the exported output value. CloudFormation returns the stack
> names that are importing this value.

` --cli-input-json  ` | ` --cli-input-yaml  ` (string) Reads arguments from the JSON string provided. The JSON string follows the format provided by ` --generate-cli-skeleton  ` . If other arguments are provided on the com