---
title: "admCreateScreen"
canonical: "https://support.appfire.com/space/PSJ/15488984/admCreateScreen"
format: markdown
---
> Macro (aura-html)


|  |  |  |  |
| --- | --- | --- | --- |
| **Syntax** | admCreateScreen(name, description) | **Package** | adm |
| **Alias** |  | **Pkg Usage** | createScreen(name, description) |

## Description

> Macro (excerpt)
> 
> Creates a new screen.

Creates a new screen.

## Parameters

| Parameter name | Type | Required | Description |
| --- | --- | --- | --- |
| name | String | Yes | Screen name. |
| description | String | Yes | Screen description (can be blank). |

## Return Type

**String**

Returns the id (as a number) of the newly created screen.

## Examples

### Example 1

Creating a screen:

```
admCreateScreen("Test Screen", "Test screen description");
```

### Example 2

Creating a screen with empty description:

```
admCreateScreen("Test Screen", "");
```

> ⚠️ The method throws an exception if the name parameter is empty or a screen with the same name already exists.

## See also

> Macro (contentbylabel)