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::Theme
<a name="aws-resource-quicksight-theme"></a>

Creates a theme.

A *theme* is set of configuration options for color and layout. Themes apply to analyses and dashboards. For more information, see [Using Themes in Amazon Quick](https://docs.aws.amazon.com/quicksight/latest/user/themes-in-quicksight.html) in the *Amazon Quick User Guide*.

## Syntax
<a name="aws-resource-quicksight-theme-syntax"></a>

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

### JSON
<a name="aws-resource-quicksight-theme-syntax.json"></a>

```
{
  "Type" : "AWS::QuickSight::Theme",
  "Properties" : {
      "[AwsAccountId](#cfn-quicksight-theme-awsaccountid)" : String,
      "[BaseThemeId](#cfn-quicksight-theme-basethemeid)" : String,
      "[Configuration](#cfn-quicksight-theme-configuration)" : ThemeConfiguration,
      "[Name](#cfn-quicksight-theme-name)" : String,
      "[Permissions](#cfn-quicksight-theme-permissions)" : [ ResourcePermission, ... ],
      "[Tags](#cfn-quicksight-theme-tags)" : [ Tag, ... ],
      "[ThemeId](#cfn-quicksight-theme-themeid)" : String,
      "[VersionDescription](#cfn-quicksight-theme-versiondescription)" : String
    }
}
```

### YAML
<a name="aws-resource-quicksight-theme-syntax.yaml"></a>

```
Type: AWS::QuickSight::Theme
Properties:
  [AwsAccountId](#cfn-quicksight-theme-awsaccountid): String
  [BaseThemeId](#cfn-quicksight-theme-basethemeid): String
  [Configuration](#cfn-quicksight-theme-configuration): 
    ThemeConfiguration
  [Name](#cfn-quicksight-theme-name): String
  [Permissions](#cfn-quicksight-theme-permissions): 
    - ResourcePermission
  [Tags](#cfn-quicksight-theme-tags): 
    - Tag
  [ThemeId](#cfn-quicksight-theme-themeid): String
  [VersionDescription](#cfn-quicksight-theme-versiondescription): String
```

## Properties
<a name="aws-resource-quicksight-theme-properties"></a>

`AwsAccountId`  <a name="cfn-quicksight-theme-awsaccountid"></a>
The ID of the AWS account where you want to store the new theme.   
*Required*: Yes  
*Type*: String  
*Pattern*: `^[0-9]{12}$`  
*Minimum*: `12`  
*Maximum*: `12`  
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)

`BaseThemeId`  <a name="cfn-quicksight-theme-basethemeid"></a>
The ID of the theme that a custom theme will inherit from. All themes inherit from one of the starting themes defined by Amazon Quick Sight. For a list of the starting themes, use `ListThemes` or choose **Themes** from within an analysis.   
*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)

`Configuration`  <a name="cfn-quicksight-theme-configuration"></a>
The theme configuration, which contains the theme display properties.  
*Required*: Yes  
*Type*: [ThemeConfiguration](aws-properties-quicksight-theme-themeconfiguration.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Name`  <a name="cfn-quicksight-theme-name"></a>
A display name for the theme.  
*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)

`Permissions`  <a name="cfn-quicksight-theme-permissions"></a>
A valid grouping of resource permissions to apply to the new theme.   
*Required*: No  
*Type*: Array of [ResourcePermission](aws-properties-quicksight-theme-resourcepermission.md)  
*Minimum*: `1`  
*Maximum*: `64`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Tags`  <a name="cfn-quicksight-theme-tags"></a>
A map of the key-value pairs for the resource tag or tags that you want to add to the resource.  
*Required*: No  
*Type*: Array of [Tag](aws-properties-quicksight-theme-tag.md)  
*Minimum*: `1`  
*Maximum*: `200`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`ThemeId`  <a name="cfn-quicksight-theme-themeid"></a>
An ID for the theme that you want to create. The theme ID is unique per AWS Region in each AWS account.  
*Required*: Yes  
*Type*: String  
*Pattern*: `^[\w\-]+$`  
*Minimum*: `1`  
*Maximum*: `512`  
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)

`VersionDescription`  <a name="cfn-quicksight-theme-versiondescription"></a>
A description of the first version of the theme that you're creating. Every time `UpdateTheme` is called, a new version is created. Each version of the theme has a description of the version in the `VersionDescription` field.  
*Required*: No  
*Type*: String  
*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)

## Return values
<a name="aws-resource-quicksight-theme-return-values"></a>

### Fn::GetAtt
<a name="aws-resource-quicksight-theme-return-values-fn--getatt"></a>

#### 
<a name="aws-resource-quicksight-theme-return-values-fn--getatt-fn--getatt"></a>

`Arn`  <a name="Arn-fn::getatt"></a>
The Amazon Resource Name (ARN) of the theme.

`CreatedTime`  <a name="CreatedTime-fn::getatt"></a>
The time the theme was created.

`LastUpdatedTime`  <a name="LastUpdatedTime-fn::getatt"></a>
The time the theme was last updated.

`Type`  <a name="Type-fn::getatt"></a>
Theme type.