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 CategoryFilterConfiguration
<a name="aws-properties-quicksight-template-categoryfilterconfiguration"></a>

The configuration for a `CategoryFilter`.

This is a union type structure. For this structure to be valid, only one of the attributes can be defined.

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

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

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

```
{
  "[CustomFilterConfiguration](#cfn-quicksight-template-categoryfilterconfiguration-customfilterconfiguration)" : CustomFilterConfiguration,
  "[CustomFilterListConfiguration](#cfn-quicksight-template-categoryfilterconfiguration-customfilterlistconfiguration)" : CustomFilterListConfiguration,
  "[FilterListConfiguration](#cfn-quicksight-template-categoryfilterconfiguration-filterlistconfiguration)" : FilterListConfiguration
}
```

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

```
  [CustomFilterConfiguration](#cfn-quicksight-template-categoryfilterconfiguration-customfilterconfiguration): 
    CustomFilterConfiguration
  [CustomFilterListConfiguration](#cfn-quicksight-template-categoryfilterconfiguration-customfilterlistconfiguration): 
    CustomFilterListConfiguration
  [FilterListConfiguration](#cfn-quicksight-template-categoryfilterconfiguration-filterlistconfiguration): 
    FilterListConfiguration
```

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

`CustomFilterConfiguration`  <a name="cfn-quicksight-template-categoryfilterconfiguration-customfilterconfiguration"></a>
A custom filter that filters based on a single value. This filter can be partially matched.  
*Required*: No  
*Type*: [CustomFilterConfiguration](aws-properties-quicksight-template-customfilterconfiguration.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`CustomFilterListConfiguration`  <a name="cfn-quicksight-template-categoryfilterconfiguration-customfilterlistconfiguration"></a>
A list of custom filter values. In the Quick Sight console, this filter type is called a custom filter list.  
*Required*: No  
*Type*: [CustomFilterListConfiguration](aws-properties-quicksight-template-customfilterlistconfiguration.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`FilterListConfiguration`  <a name="cfn-quicksight-template-categoryfilterconfiguration-filterlistconfiguration"></a>
A list of filter configurations. In the Quick Sight console, this filter type is called a filter list.  
*Required*: No  
*Type*: [FilterListConfiguration](aws-properties-quicksight-template-filterlistconfiguration.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)