---
title: "tinymce.WindowManager"
description: "This class handles the creation of native windows and dialogs. This class can be extended to provide for example inline dialogs."
canonical_url: "https://www.tiny.cloud/docs/tinymce/latest/apis/tinymce.windowmanager/"
md_url: "https://www.tiny.cloud/docs/tinymce/5/apis/tinymce.windowmanager/index.md"
version: "5"
last_updated: "2024-03-26T08:09:19Z"
tokens: 840
---
Important This page documents TinyMCE 5. For new projects, Tiny recommends using the latest, most up-to-date version. [See TinyMCE 8 documentation](../../../latest/apis/tinymce.windowmanager/).
# tinymce.WindowManager

This class handles the creation of native windows and dialogs. This class can be extended to provide for example inline dialogs.

## Examples

```javascript
// Opens a new dialog with the file.htm file and the size 320x240
// It also adds a custom parameter this can be retrieved by using tinyMCEPopup.getWindowArg inside the dialog.
tinymce.activeEditor.windowManager.open({
   url: 'file.htm',
   width: 320,
   height: 240
}, {
   custom_param: 1
});

// Displays an alert box using the active editors window manager instance
tinymce.activeEditor.windowManager.alert('Hello world!');

// Displays an confirm box and an alert message will be displayed depending on what you choose in the confirm
});
```

## Summary

### Methods

| Name | Summary | Defined by |
| --- | --- | --- |
| [alert()](#alert) | Creates an alert dialog. Please don’t use the blocking behavior of this native version use the callback method instead then it can be extended. | `WindowManager` |
| [close()](#close) | Closes the top most window. | `WindowManager` |
| [confirm()](#confirm) | Creates a confirm dialog. Please don’t use the blocking behavior of this native version use the callback method instead then it can be extended. | `WindowManager` |
| [open()](#open) | Opens a new window. | `WindowManager` |
| [openUrl()](#openUrl) | Opens a new window for the specified url. | `WindowManager` |

## Methods

### alert()

```javascript
alert(message: String, callback: function, scope: Object)
```
Creates an alert dialog. Please don’t use the blocking behavior of this
native version use the callback method instead then it can be extended.

#### Examples

```javascript
// Displays an alert box using the active editors window manager instance
tinymce.activeEditor.windowManager.alert('Hello world!');
```

#### Parameters

- `message (String)` - Text to display in the new alert dialog.
- `callback (function)` - (Optional) Callback function to be executed after the user has selected ok.
- `scope (Object)` - (Optional) Scope to execute the callback in.

### close()

```javascript
close()
```
Closes the top most window.

### confirm()

```javascript
confirm(message: String, callback: function, scope: Object)
```
Creates a confirm dialog. Please don’t use the blocking behavior of this
native version use the callback method instead then it can be extended.

#### Examples

```javascript
// Displays an confirm box and an alert message will be displayed depending on what you choose in the confirm
tinymce.activeEditor.windowManager.confirm("Do you want to do something", function(s) {
   if (s)
      tinymce.activeEditor.windowManager.alert("Ok");
   else
      tinymce.activeEditor.windowManager.alert("Cancel");
});
```

#### Parameters

- `message (String)` - Text to display in the new confirm dialog.
- `callback (function)` - (Optional) Callback function to be executed after the user has selected ok or cancel.
- `scope (Object)` - (Optional) Scope to execute the callback in.

### open()

```javascript
open(args: Object)
```
Opens a new window.

#### Parameters

- `args (Object)` - For a list of options, see: [Dialog - Configuration options](/docs/ui-components/dialog/#configurationoptions).

### openUrl()

```javascript
openUrl(args: Object)
```
Opens a new window for the specified url.

#### Parameters

- `args (Object)` - For a list of options, see: [URL dialog configuration](/docs/ui-components/urldialog/#urldialogconfiguration).