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 your app's dashboard.

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 app dashboard does not support making requests to non-https servers.
  2. Select an app from the Custom Apps page in your Wix Studio workspace.
  3. Go to Extensions and click + Create Extension.
  4. In the Choose the extension you want to create modal, select Dashboard Page and click Create.
  5. On the Dashboard Page extension configuration page, fill in the following fields:
FieldDescription
General > NameRequired. An internal name used in the app dashboard 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.

Manage and customize your dashboard page

Now that your dashboard page is set up you can manage and customize your dashboard page.

  1. Manage your dashboard page with the dashboard SDK.

    Access data from the dashboard page using the observeState() SDK function in your dashboard page extension:

    Copy

    Note: If you use a menu plugin extension to navigate to your dashboard page, data from the page hosting the menu plugin, such as an ID, is passed through the menu plugin slot to your dashboard page extension.

  2. Design your dashboard page's UI. Consider using the Wix Design System, a collection of reusable React components that you can use to make your app appear and feel like a native Wix 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 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. Go to Extensions in your app's dashboard.

  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