Add Self-hosted Dashboard Page Extensions

This article describes how to add a dashboard page extension using the Wix Dev Center.

  1. Build your app using the technologies of your choice. Make sure your app:
    • Is hosted on a publicly accessible server.
    • Is served on an https URL, not an http one. For security reasons, the Wix Dev Center does not support making requests to non-https servers.
  2. In the Dev Center, create a new app.
  3. In your new app’s page in the Dev Center, click Extensions in the sidebar menu.
  4. Click Create Extension.
  5. In the Choose the extension you want to create modal, select Dashboard Page and click Create.
  6. On the Dashboard Page extension configuration page, fill in the following fields:
FieldMeaning
General > NameRequired. An internal name used in the Dev Center to manage this page.
General > Extension IDA unique Wix-generated ID used to identify this extension. Use this identifier with the Dashboard SDK to trigger navigation between your app’s pages.
Page Info > iFrame URLRequired. Your app server’s address. This is what is rendered in the iFrame on the dashboard.

The App Instance query parameter is attached to the dashboard URL so that you can identify the user when they view your page.

Note: For security reasons, your app must be hosted on an https address.
Page info > Relative routeRequired. A path suffix to append to the URL when users visit your page in the dashboard. For example, https://manage.wix.com/dashboard/<site_identifier_guid>/app/<app_identifier_guid>/<relative_route_used>.
Page info > Hide the sidebar menu when your page is openWhether to hide the sidebar menu when your dashboard page is viewed.
Sidebar configuration > Page nameRequired. A name for the dashboard page that appears in the sidebar menu.

  1. Click Save > Save to save your changes.

Notify users about an event or action required in your app

If you want to notify a user about something that happened in your app or an action they must take, you can direct them to your app instance installed on a specific Wix site. Use the following URL: https://www.wix.com/my-account/app/<appID>/<appInstanceID>.

You can get the app instance ID by decoding it from the app instance query parameter in the iFrame URL.

Add and organize multiple dashboard pages

Your app can include multiple dashboard pages. For example, it might include an overview page and a settings page. Multiple dashboard pages are bundled in the sidebar menu under your app’s name. When a user clicks or hovers over it, a submenu appears with all your dashboard pages.

To manage multiple dashboard pages: In the sidebar menu of the Dev Center, click Extensions. In the top-level menu item, click the ellipsis icon and click Change page order.

In the Manage Dashboard pages modal, rearrange the pages as you’d like them to appear in the side menu of the user’s dashboard.

The top-level menu item displays your app’s name, with dashboard page extensions listed as sub-items. Each extension is named based on the value specified in the Page name field on its configuration page.

You can rename any of these menu items by hovering over them and clicking the pencil icon.

Click Save to save your changes.

See also

Was this helpful?
Yes
No