Add External URL Extensions with the Wix CLI

You can use the external URL extension to refer users from the dashboard of a Wix site or project to your service outside the Wix platform. The extension adds a link to your service on the Manage Apps page in the site dashboard. When a site collaborator clicks the link, your external service opens in a new browser tab.

The Wix CLI makes it easy to create and manage your external URL extension.

Note: You can only create one external URL extension per app.

For general information about this extension type, read About External URL Extensions.

Build your service

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 app dashboard does not support making requests to non-https servers.

Add the extension

  1. Run the generate command and follow the prompts to create an external URL extension:

    Copy
    1. Select Dashboard External Page as the extension type.
    2. Enter a name for your extension's folder. The CLI creates a directory with this name containing your extension files.
    3. Enter the URL for your external service. When a site collaborator opens your app from the Manage Apps page in their site dashboard, this address is opened in a new browser tab.

Upon completion, the extension files will be created in your project directory with the following structure:

Copy

Note: This is the default folder structure created by the CLI. You can move these files to any location within the src/ folder and update the references in your extensions.ts file. Learn more about the flexible file system.

For more information about these files, see External URL Extension Files and Code.

Important: The external URL extension is registered in the dashboard only after you release a new version of your app. Until then, the extension won't appear in the Manage Apps page.

Build and deploy your project

Once your project is ready for production, you can build and deploy it.

Note: When you release an app project, you release a new version of the app allowing you to publish the app to the Wix App Market or install it on a site with a direct install URL. You can view your app's versions in the app dashboard.

Delete an external URL extension

To delete an existing external URL extension from your project:

  1. Delete the folder that contains your extension's files.
  2. Remove the import and .use() statements for the extension from the extensions.ts file.

If you already have a version of your app project, you must build and deploy the project again after removing the extension files.

See also

Last updated: 16 July 2026

Did this help?