External URL Extensions

An external URL extension adds a link in the Wix dashboard that points to a destination outside Wix. When a Wix user clicks the link, the destination opens in a new browser tab. The dashboard passes app instance data as a query parameter so the receiving service can identify the calling site.

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

External URL extension link on the Manage Apps page in the Wix dashboard

When to use an external URL extension

Use an external URL extension when you want to give Wix users a one-click jump from the dashboard to a destination you host outside Wix. Common cases include:

  • Linking to your service's web app when the experience is too extensive to embed in a dashboard page, like a full project management tool with its own navigation.
  • Linking to a hosted help center or documentation site, like a "Help" link that opens your knowledge base.

For destinations inside the Wix dashboard, use a dashboard page or dashboard menu plugin instead.

External URL configuration

An external URL extension is configuration only. It doesn't render UI in the dashboard and it doesn't run code there. An app can register only 1 external URL extension.

In a Wix CLI app, the extension is a single configuration file. The file sets the extension ID and the destination URL. For the file and the configuration fields, see External URL Extension Files and Code.

Self-managed apps and Blocks apps set the destination URL in the App Dashboard. See Add External URL Extensions in Build Apps.

External URL extensions across development paths

The development path determines how you register an external URL extension:

  • Sites: Don't add external URL extensions directly, in Studio Two, Wix Studio, or Wix Editor. To add an external URL extension, create a private app that registers it and install that app on the site.
  • Wix-managed headless projects: Don't support external URL extensions.
  • Self-managed headless projects: Don't support external URL extensions.
  • Wix-managed apps: Use the Wix CLI. See Add External URL Extensions with the Wix CLI.
  • Self-managed apps: Configure the external URL in the App Dashboard. See Add External URL Extensions in Build Apps.
  • Blocks apps: Configure the external URL in the App Dashboard. See Add External URL Extensions in Build Apps.

Last updated: 2 November 2026

Did this help?