---
title: "addScreenTab"
canonical: "https://support.appfire.com/space/JCLI/70782307/addScreenTab"
format: markdown
---
> Macro (aura-html)

See also: [Actions](https://appfire.atlassian.net/wiki/spaces/JCLI/pages/70787366)

> Macro (details)
> 
> | **Description** | Adds a new screen tab. You can provide required parameter screen by id or name, but id is strongly recommended. Name of new tab is also required by parameter tab or name. |
> | --- | --- |
> | **Required Parameters** | [screen](https://appfire.atlassian.net/wiki/spaces/JCLI/pages/70784337), [tab](https://appfire.atlassian.net/wiki/spaces/JCLI/pages/70782597) |
> | **Optional Parameters** | [continue](https://appfire.atlassian.net/wiki/spaces/JCLI/pages/70790023) |
> | **Type** | [Create](https://appfire.atlassian.net/wiki/spaces/JCLI/pages/70780909/Action+Types#ActionTypes-Create) |
> | **Category** | [Screens](https://appfire.atlassian.net/wiki/spaces/JCLI/pages/70780591/Action+Categories#ActionCategories-Screens) |
> | **Output Formats** |  |
> | **Replacement Variables** | tab, tabId |
> | **Hosting** | cloud,server,datacenter |
> | **Since Version** | 9.6 |
> | **Examples** | [addScreenTab](https://appfire.atlassian.net/wiki/spaces/JCLI/pages/70782732/Examples#Examples-addScreenTab) |

## Related How To's

> Macro (cql-query)