# AddAlternateStateAsync Method

## Overloads

| [AddAlternateStateAsync(String)](https://help.qlik.com/en-US/sense-developer/May2026/Subsystems/NetSDKAPIref/Content/Qlik.Engine.App.AddAlternateStateAsync.htm#Qlik_Engine_App_AddAlternateStateAsync_System_String_) |  | Adds an alternate state in the app.<br><br>You can create multiple states within a Qlik Sense app and apply these states to specific objects within the app. Objects in a given state are not affected by user selections in the other states. |
| --- | --- | --- |
| [AddAlternateStateAsync(AsyncHandle, String)](https://help.qlik.com/en-US/sense-developer/May2026/Subsystems/NetSDKAPIref/Content/Qlik.Engine.App.AddAlternateStateAsync.htm#Qlik_Engine_App_AddAlternateStateAsync_Qlik_Engine_AsyncHandle_System_String_) |  | Adds an alternate state in the app.<br><br>You can create multiple states within a Qlik Sense app and apply these states to specific objects within the app. Objects in a given state are not affected by user selections in the other states. |

[](https://help.qlik.com/en-US/sense-developer/Subsystems/NetSDKAPIref/Content/Qlik.Engine.App.AddAlternateStateAsync.htm) [](https://help.qlik.com/en-US/sense-developer/Subsystems/NetSDKAPIref/Content/Qlik.Engine.App.AddAlternateStateAsync.htm)

## AddAlternateStateAsync(String)

Adds an alternate state in the app.

You can create multiple states within a Qlik Sense app and apply these states to specific objects within the app. Objects in a given state are not affected by user selections in the other states.

### Declaration

```

          public Task AddAlternateStateAsync([QixName("qStateName")] string stateName)
    
  
```

### Parameters

| Type | Name | Description |
| --- | --- | --- |
| System.String | stateName | Name of the alternate state. |

### Returns

| Type | Description |
| --- | --- |
| System.Threading.Tasks.Task |  |

### Implements

[IApp.AddAlternateStateAsync(String)](https://help.qlik.com/en-US/sense-developer/May2026/Subsystems/NetSDKAPIref/Content/Qlik.Engine.IApp.AddAlternateStateAsync.htm#Qlik_Engine_IApp_AddAlternateStateAsync_System_String_)

[](https://help.qlik.com/en-US/sense-developer/Subsystems/NetSDKAPIref/Content/Qlik.Engine.App.AddAlternateStateAsync.htm) [](https://help.qlik.com/en-US/sense-developer/Subsystems/NetSDKAPIref/Content/Qlik.Engine.App.AddAlternateStateAsync.htm)

## AddAlternateStateAsync(AsyncHandle, String)

Adds an alternate state in the app.

You can create multiple states within a Qlik Sense app and apply these states to specific objects within the app. Objects in a given state are not affected by user selections in the other states.

### Declaration

```

          public Task AddAlternateStateAsync(AsyncHandle asyncHandle, [QixName("qStateName")] string stateName)
    
  
```

### Parameters

| Type | Name | Description |
| --- | --- | --- |
| [AsyncHandle](https://help.qlik.com/en-US/sense-developer/May2026/Subsystems/NetSDKAPIref/Content/Qlik.Engine.AsyncHandle.htm) | asyncHandle | Handle to asynchronous method request |
| System.String | stateName | Name of the alternate state. |

### Returns

| Type | Description |
| --- | --- |
| System.Threading.Tasks.Task |  |

### Implements

[IApp.AddAlternateStateAsync(AsyncHandle, String)](https://help.qlik.com/en-US/sense-developer/May2026/Subsystems/NetSDKAPIref/Content/Qlik.Engine.IApp.AddAlternateStateAsync.htm#Qlik_Engine_IApp_AddAlternateStateAsync_Qlik_Engine_AsyncHandle_System_String_)