Add Self-hosted Dashboard Page Extensions

The dashboard page extension adds an iframe page to a site dashboard. Add a self-hosted dashboard page in the Wix Dev Center.

Note: For a more streamlined approach to developing your dashboard page, try out the Wix CLI or Blocks instead of self-hosting.

Add a dashboard page

  1. Build your extension using the technologies of your choice. Make sure your iframe extension:
    • 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, open or create an app and click Create Extension.
  3. In the Choose the extension you want to create modal, select Dashboard Page and click Create.
  4. On the Dashboard Page extension configuration page, fill in the following fields:
FieldDescription
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. Content hosted there is rendered in the iFrame on the dashboard.

The app instance data is appended to the iFrame URL as an encoded query parameter, instance, so that you can identify the site owner 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 to save your changes.

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 parsing it from the app instance query parameter in the iFrame URL, or by calling the Get App Instance endpoint.

Organize multiple dashboard pages

Your app can include multiple dashboard pages, for example, 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:

  1. In the sidebar menu of the Dev Center, click Extensions.

  2. In the top-level menu item, click the ellipsis icon and click Change page order.

  3. 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.

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

  5. Click Save.

See also

Was this helpful?
Yes
No