openModal()
Opens a dashboard modal extension on your app's dashboard page.
Notes:
- This method doesn't yet work when developing sites or building apps with Blocks.
- Before you call this method, you need a dashboard modal extension. Learn more about implementing dashboard modal extensions with the Wix CLI and in self-managed apps.
Method declaration
Copy
Parameters
| Name | Type | Description |
|---|---|---|
modalInfo | ModalInfo | Information about the dashboard modal to open. |
Note: openModal() used to accept 2 parameters: modalId and params. These parameters have been wrapped inside a modalInfo object. Using 2 parameters is deprecated but still supported.
ModalInfo object
| Name | Type | Description |
|---|---|---|
modalId | string | ID of the dashboard modal extension to open. You can find this ID in your app's dashboard, in the modal extension's settings. |
params | Record<string, any> | Optional. Custom data to pass into the dashboard modal extension. The extension can access this data using observeState(). |
Returns
Copy
Note: Don't use relative CSS height units such as vh in the extensions opened by this method. The host adjusts extension heights automatically. If your extension uses relative height units by default, make sure to turn them off.
Examples
Note: To call this method in self-managed apps, you need to create a client. See the setup guide for more details.
Open a modal
Copy
Pass extra data to a modal
Copy
You can access the data passed to openModal() in your extension code using observeState().
Get notified when the modal is closed
Copy
Last updated: 17 June 2026
Did this help?