# Theme alias operations


A *theme alias* is a reference to a version of a theme. For example, suppose that you create the theme alias `exampleAlias` for version 1 of the theme `exampleTheme`. You can use the theme alias *`exampleAlias`* to reference version 1 of theme exampleTheme in a `DescribeTheme` API operation, as in the following example.

**Example**  

```
aws quicksight describe-theme 
    --aws-account-id AWSACCOUNTID 
    --theme-id exampleThemeID 
    --alias-name exampleAlias
```

With theme alias operations, you can perform actions on Quick Sight theme aliases. For more information, see the following API operations.

**Topics**
+ [

# CreateThemeAlias
](create-theme-alias.md)
+ [

# DeleteThemeAlias
](delete-theme-alias.md)
+ [

# DescribeThemeAlias
](describe-theme-alias.md)
+ [

# ListThemeAliases
](list-theme-aliases.md)
+ [

# UpdateThemeAlias
](update-theme-alias.md)

# CreateThemeAlias


The `CreateThemeAlias` operation creates a theme alias for a theme. To use this operation, you need the ID of the theme that you want to create an alias for. You can use the `ListThemes` operation to list all themes and their corresponding theme IDs.

Following is an example AWS CLI command for this operation.

------
#### [ AWS CLI ]

```
aws quicksight 
    --aws-account-id AWSACCOUNTID 
    --theme-id THEMEID 
    --alias-name ALIAS 
    --theme-version-number VERSION
```

You can also make this command using a CLI skeleton file with the following command. For more information about CLI skeleton files, see [Use CLI skeleton files](cli-skeletons.md).

```
aws quicksight create-theme-alias
    --cli-input-json file://create-theme-alias.json
```

------

For more information about the `CreateThemeAlias` operation, see [CreateThemeAlias](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_CreateThemeAlias) in the *Quick Sight API Reference*.

# DeleteThemeAlias


Use the `DeleteThemeAlias` operation to delete the version of the theme that the specified theme alias points to. If you provide a specific alias, you delete the version of the theme that the alias points to. To use this operation, you need the ID of the theme that is using the alias that you want to delete. You can use the `ListThemes` operation to list all themes and their corresponding theme IDs.

Following is an example AWS CLI command for this operation.

------
#### [ AWS CLI ]

```
aws quicksight delete-theme-alias 
    --aws-account-id AWSACCOUNTID 
    --theme-id THEMEID 
    --alias-name ALIAS
```

------

For more information about the `DeleteThemeAlias` operation, see [DeleteThemeAlias](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_DeleteThemeAlias) in the *Quick Sight API Reference*.

# DescribeThemeAlias


Use the `DescribeThemeAlias` operation to describe the alias for a theme. To use this operation, you need the ID of the theme that is using the alias that you want to describe. You can use the `ListThemes` operation to list all themes and their corresponding theme IDs.

Following is an example AWS CLI command for this operation.

------
#### [ AWS CLI ]

```
aws quicksight describe-theme-alias 
    --aws-account-id AWSACCOUNTID 
    --theme-id THEMEID 
    --alias-name ALIAS
```

------

For more information about the `DescribeThemeAlias` operation, see [DescribeThemeAlias](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_DescribeThemeAlias) in the *Quick Sight API Reference*.

# ListThemeAliases


Use the `ListThemeAliases` operation to list all the aliases of a theme. To use this operation, you need the ID of the theme that is using the aliases that you want described. You can use the `ListThemes` operation to list all themes and their corresponding theme IDs.

Following is an example AWS CLI command for this operation.

------
#### [ AWS CLI ]

```
aws quicksight list-theme-aliases 
    --aws-account-id AWSACCOUNTID 
    --theme-id THEMEID 
    --max-results 100
```

------

For more information about the `ListThemeAliases` operation, see [ListThemeAliases](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_ListThemeAliases) in the *Quick Sight API Reference*.

# UpdateThemeAlias


Use the `UpdateThemeAlias` operation to update an alias of a theme. To use this operation, you need the ID of the theme that is using the alias that you want to update. You can use the `ListThemes` operation to list all themes and their corresponding theme IDs.

Following is an example AWS CLI command for this operation.

------
#### [ AWS CLI ]

```
aws quicksight update-theme-alias 
    --aws-account-id AWSACCOUNTID 
    --theme-id THEMEID 
    --alias-name ALIAS 
    --theme-version-number VERSION
```

You can also make this command using a CLI skeleton file with the following command. For more information about CLI skeleton files, see [Use CLI skeleton files](cli-skeletons.md).

```
aws quicksight update-theme-alias 
    --cli-input-json file://updatethemealias.json
```

------

For more information about the `UpdateThemeAlias` operation, see [UpdateThemeAlias](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_UpdateThemeAlias) in the *Quick Sight API Reference*.