Use when adding popup forms, confirmations, or detail views to Wix dashboards; creating reusable dialog components across dashboard pages; showing…
Overview
Dashboard modals are popup dialogs triggered from dashboard pages or plugins. They consist of three files and use the Dashboard SDK for lifecycle control via openModal() and closeModal().
Quick Reference
Task
Method
Example
Create modal
Create 3 files in src/extensions/dashboard/modals/<folder>/
See File Structure below
Open modal
dashboard.openModal()
openModal({ modalId: "modal-id" })
Pass data to modal
params in openModal()
params: { userId: "123" }
Read data in modal
observeState()
dashboard.observeState((state) => { ... })
Close modal
dashboard.closeModal()
closeModal()
Return data to parent
Pass data to closeModal()
closeModal({ ... })
Wait for modal close
modalClosed Promise
const { modalClosed } = openModal(...);
File Structure
Create three files in src/extensions/dashboard/modals/<folder-name>/:don't have the plugin yet? install it then click "run inline in claude" again.