Dashboard Pages

A dashboard page occupies a full page in the Wix dashboard. Unlike modals, plugins, and menu items, which extend or attach to existing pages, a dashboard page is a new standalone destination.

Pages can be placed in the dashboard navigation or hidden and reached programmatically.

Like all dashboard extensions, dashboard pages don't appear on the live site. Only Wix users with the required permissions can see them.

A dashboard page in the Wix dashboard

When to use a dashboard page

Use a dashboard page when you need significant screen space and a self-contained workflow. Common cases include:

  • Rendering site or business data for monitoring and analysis, like a sales summary with charts and exports.
  • Configuring app or site behavior, like notification or email preferences.
  • Integrating data or services hosted outside Wix, like a shipping carrier rate lookup.
  • Providing a multi-view interface under a single page using SPA-style internal routing.

For lighter or more contextual interactions, choose another dashboard extension type.

Page code

In Studio Two site projects and Wix CLI projects, a dashboard page is a configuration file that declares the page plus a React component that renders it. For the file set and configuration fields, see Dashboard Page Extension Files and Code. On other paths a page is structured differently: Blocks pages are built in a visual editor, and self-managed pages are iframes you build and host yourself.

Use the Dashboard SDK at runtime to read host context, navigate between dashboard locations, and open modals. Call other Wix APIs from inside the dashboard to read and write site data, including the business solution APIs.

To send a Wix user from one dashboard page to another, call navigate(). The destination is always a dashboard page. Plugins, menu plugins, and other dashboard surfaces can call the same method. For the full contract, see About Dashboard Page Navigation.

To send the Wix user to a dashboard page built by Wix, see About Navigating to Dashboard Pages Built by Wix.

When you're writing the UI in React, prefer the Wix Design System and Patterns. They're React component libraries that match the native Wix dashboard look.

Authentication and permissions

Dashboard page code runs with the identity of the Wix user viewing it, the site owner or a collaborator who's logged into the dashboard.

What the page can do is bounded 2 ways:

  • The Wix user's role on the site determines which methods they're allowed to invoke.
  • When the page belongs to an installed app, the app declares the permission scopes the page needs in its manifest, and those scopes further constrain what the page can call.

For some restricted methods, you can elevate the call from backend code to gain higher authorization than the current user has.

Dashboard pages across development paths

The development path determines how you build a dashboard page:

Last updated: 2 November 2026

Did this help?