---
url: /process-functions/security-application-screens.md
description: An application's screens.
---

#  ApplicationScreens 

An application's screens.

```js
const app = security.application("My Application");
const screen = app.screens.create("Planner", "planner-page");
```

## Constructor

Reached through the [screens](/process-functions/security-application#properties) property of an [ApplicationSecurity](/process-functions/security-application). It can't be created directly.

## Methods

### list `list()`  {#list}

Returns a summary of every screen, in the order they're defined. Each entry is the same object [json()](/process-functions/security-application-screen#json) returns.

### get `get(screenNameOrId)`  {#get}

Returns an [ApplicationScreen](/process-functions/security-application-screen), or `null` when there's no such screen.

| Parameter | Type | Description |
|---|---|---|
| `screenNameOrId` | `string` | The screen's title or id. |

### exists `exists(screenNameOrId)`  {#exists}

Returns `true` when the screen exists.

| Parameter | Type | Description |
|---|---|---|
| `screenNameOrId` | `string` | The screen's title or id. |

### create `create(title, route)`  {#create}

Creates a screen and returns it as an [ApplicationScreen](/process-functions/security-application-screen).

| Parameter | Type | Description |
|---|---|---|
| `title` | `string` | The screen's title, up to 150 characters. |
| `route` | `string` | The screen's route. It must be unique in the application. |

### remove `remove(screenNameOrId)`  {#remove}

Deletes a screen. Returns `true` when it was deleted.

| Parameter | Type | Description |
|---|---|---|
| `screenNameOrId` | `string` | The screen's title or id. |

### removeAll `removeAll()`  {#removeall}

Deletes every screen in the application.

## Examples

```js
const app = security.application("My Application");
const screens = app.screens;

const plannerScreen = screens.create("Planner", "planner-page");
plannerScreen.setPage("page", "My Planner Page");

console.log(screens.exists("Planner"));
console.log(plannerScreen.json());
```

## Related

* [ApplicationScreen](/process-functions/security-application-screen): a single screen.
* [ScreenTag](/process-functions/security-application-screentag): controls who can see screens.