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::Analysis Filter
<a name="aws-properties-quicksight-analysis-filter"></a>

With a `Filter`, you can remove portions of data from a particular visual or view.

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-analysis-filter-syntax"></a>

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

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

```
{
  "[CategoryFilter](#cfn-quicksight-analysis-filter-categoryfilter)" : CategoryFilter,
  "[NestedFilter](#cfn-quicksight-analysis-filter-nestedfilter)" : NestedFilter,
  "[NumericEqualityFilter](#cfn-quicksight-analysis-filter-numericequalityfilter)" : NumericEqualityFilter,
  "[NumericRangeFilter](#cfn-quicksight-analysis-filter-numericrangefilter)" : NumericRangeFilter,
  "[RelativeDatesFilter](#cfn-quicksight-analysis-filter-relativedatesfilter)" : RelativeDatesFilter,
  "[TimeEqualityFilter](#cfn-quicksight-analysis-filter-timeequalityfilter)" : TimeEqualityFilter,
  "[TimeRangeFilter](#cfn-quicksight-analysis-filter-timerangefilter)" : TimeRangeFilter,
  "[TopBottomFilter](#cfn-quicksight-analysis-filter-topbottomfilter)" : TopBottomFilter
}
```

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

```
  [CategoryFilter](#cfn-quicksight-analysis-filter-categoryfilter): 
    CategoryFilter
  [NestedFilter](#cfn-quicksight-analysis-filter-nestedfilter): 
    NestedFilter
  [NumericEqualityFilter](#cfn-quicksight-analysis-filter-numericequalityfilter): 
    NumericEqualityFilter
  [NumericRangeFilter](#cfn-quicksight-analysis-filter-numericrangefilter): 
    NumericRangeFilter
  [RelativeDatesFilter](#cfn-quicksight-analysis-filter-relativedatesfilter): 
    RelativeDatesFilter
  [TimeEqualityFilter](#cfn-quicksight-analysis-filter-timeequalityfilter): 
    TimeEqualityFilter
  [TimeRangeFilter](#cfn-quicksight-analysis-filter-timerangefilter): 
    TimeRangeFilter
  [TopBottomFilter](#cfn-quicksight-analysis-filter-topbottomfilter): 
    TopBottomFilter
```

## Properties
<a name="aws-properties-quicksight-analysis-filter-properties"></a>

`CategoryFilter`  <a name="cfn-quicksight-analysis-filter-categoryfilter"></a>
A `CategoryFilter` filters text values.  
For more information, see [Adding text filters](https://docs.aws.amazon.com/quicksight/latest/user/add-a-text-filter-data-prep.html) in the *Amazon Quick Suite User Guide*.  
*Required*: No  
*Type*: [CategoryFilter](aws-properties-quicksight-analysis-categoryfilter.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`NestedFilter`  <a name="cfn-quicksight-analysis-filter-nestedfilter"></a>
A `NestedFilter` filters data with a subset of data that is defined by the nested inner filter.  
*Required*: No  
*Type*: [NestedFilter](aws-properties-quicksight-analysis-nestedfilter.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`NumericEqualityFilter`  <a name="cfn-quicksight-analysis-filter-numericequalityfilter"></a>
A `NumericEqualityFilter` filters numeric values that equal or do not equal a given numeric value.  
*Required*: No  
*Type*: [NumericEqualityFilter](aws-properties-quicksight-analysis-numericequalityfilter.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`NumericRangeFilter`  <a name="cfn-quicksight-analysis-filter-numericrangefilter"></a>
A `NumericRangeFilter` filters numeric values that are either inside or outside a given numeric range.  
*Required*: No  
*Type*: [NumericRangeFilter](aws-properties-quicksight-analysis-numericrangefilter.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`RelativeDatesFilter`  <a name="cfn-quicksight-analysis-filter-relativedatesfilter"></a>
A `RelativeDatesFilter` filters date values that are relative to a given date.  
*Required*: No  
*Type*: [RelativeDatesFilter](aws-properties-quicksight-analysis-relativedatesfilter.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`TimeEqualityFilter`  <a name="cfn-quicksight-analysis-filter-timeequalityfilter"></a>
A `TimeEqualityFilter` filters date-time values that equal or do not equal a given date/time value.  
*Required*: No  
*Type*: [TimeEqualityFilter](aws-properties-quicksight-analysis-timeequalityfilter.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`TimeRangeFilter`  <a name="cfn-quicksight-analysis-filter-timerangefilter"></a>
A `TimeRangeFilter` filters date-time values that are either inside or outside a given date/time range.  
*Required*: No  
*Type*: [TimeRangeFilter](aws-properties-quicksight-analysis-timerangefilter.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`TopBottomFilter`  <a name="cfn-quicksight-analysis-filter-topbottomfilter"></a>
A `TopBottomFilter` filters data to the top or bottom values for a given column.  
*Required*: No  
*Type*: [TopBottomFilter](aws-properties-quicksight-analysis-topbottomfilter.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)