This is the new *CloudFormation Template Reference Guide*. Please update your bookmarks and links. For help getting started with CloudFormation, see the [AWS CloudFormation User Guide](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).

# AWS::QuickSight::Template ParameterDropDownControl
<a name="aws-properties-quicksight-template-parameterdropdowncontrol"></a>

A control to display a dropdown list with buttons that are used to select a single value.

## Syntax
<a name="aws-properties-quicksight-template-parameterdropdowncontrol-syntax"></a>

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

### JSON
<a name="aws-properties-quicksight-template-parameterdropdowncontrol-syntax.json"></a>

```
{
  "[CascadingControlConfiguration](#cfn-quicksight-template-parameterdropdowncontrol-cascadingcontrolconfiguration)" : CascadingControlConfiguration,
  "[CommitMode](#cfn-quicksight-template-parameterdropdowncontrol-commitmode)" : String,
  "[DisplayOptions](#cfn-quicksight-template-parameterdropdowncontrol-displayoptions)" : DropDownControlDisplayOptions,
  "[ParameterControlId](#cfn-quicksight-template-parameterdropdowncontrol-parametercontrolid)" : String,
  "[SelectableValues](#cfn-quicksight-template-parameterdropdowncontrol-selectablevalues)" : ParameterSelectableValues,
  "[SourceParameterName](#cfn-quicksight-template-parameterdropdowncontrol-sourceparametername)" : String,
  "[Title](#cfn-quicksight-template-parameterdropdowncontrol-title)" : String,
  "[Type](#cfn-quicksight-template-parameterdropdowncontrol-type)" : String
}
```

### YAML
<a name="aws-properties-quicksight-template-parameterdropdowncontrol-syntax.yaml"></a>

```
  [CascadingControlConfiguration](#cfn-quicksight-template-parameterdropdowncontrol-cascadingcontrolconfiguration): 
    CascadingControlConfiguration
  [CommitMode](#cfn-quicksight-template-parameterdropdowncontrol-commitmode): String
  [DisplayOptions](#cfn-quicksight-template-parameterdropdowncontrol-displayoptions): 
    DropDownControlDisplayOptions
  [ParameterControlId](#cfn-quicksight-template-parameterdropdowncontrol-parametercontrolid): String
  [SelectableValues](#cfn-quicksight-template-parameterdropdowncontrol-selectablevalues): 
    ParameterSelectableValues
  [SourceParameterName](#cfn-quicksight-template-parameterdropdowncontrol-sourceparametername): String
  [Title](#cfn-quicksight-template-parameterdropdowncontrol-title): String
  [Type](#cfn-quicksight-template-parameterdropdowncontrol-type): String
```

## Properties
<a name="aws-properties-quicksight-template-parameterdropdowncontrol-properties"></a>

`CascadingControlConfiguration`  <a name="cfn-quicksight-template-parameterdropdowncontrol-cascadingcontrolconfiguration"></a>
The values that are displayed in a control can be configured to only show values that are valid based on what's selected in other controls.  
*Required*: No  
*Type*: [CascadingControlConfiguration](aws-properties-quicksight-template-cascadingcontrolconfiguration.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`CommitMode`  <a name="cfn-quicksight-template-parameterdropdowncontrol-commitmode"></a>
The visibility configuration of the Apply button on a `ParameterDropDownControl`.  
*Required*: No  
*Type*: String  
*Allowed values*: `AUTO | MANUAL`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`DisplayOptions`  <a name="cfn-quicksight-template-parameterdropdowncontrol-displayoptions"></a>
The display options of a control.  
*Required*: No  
*Type*: [DropDownControlDisplayOptions](aws-properties-quicksight-template-dropdowncontroldisplayoptions.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`ParameterControlId`  <a name="cfn-quicksight-template-parameterdropdowncontrol-parametercontrolid"></a>
The ID of the `ParameterDropDownControl`.  
*Required*: Yes  
*Type*: String  
*Pattern*: `^[\w\-]+$`  
*Minimum*: `1`  
*Maximum*: `512`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`SelectableValues`  <a name="cfn-quicksight-template-parameterdropdowncontrol-selectablevalues"></a>
A list of selectable values that are used in a control.  
*Required*: No  
*Type*: [ParameterSelectableValues](aws-properties-quicksight-template-parameterselectablevalues.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`SourceParameterName`  <a name="cfn-quicksight-template-parameterdropdowncontrol-sourceparametername"></a>
The source parameter name of the `ParameterDropDownControl`.  
*Required*: Yes  
*Type*: String  
*Pattern*: `^[a-zA-Z0-9]+$`  
*Minimum*: `1`  
*Maximum*: `2048`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Title`  <a name="cfn-quicksight-template-parameterdropdowncontrol-title"></a>
The title of the `ParameterDropDownControl`.  
*Required*: Yes  
*Type*: String  
*Minimum*: `1`  
*Maximum*: `2048`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Type`  <a name="cfn-quicksight-template-parameterdropdowncontrol-type"></a>
The type parameter name of the `ParameterDropDownControl`.  
*Required*: No  
*Type*: String  
*Allowed values*: `MULTI_SELECT | SINGLE_SELECT`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)