> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Add External URL Extensions with the Wix CLI

## Article: Add External URL Extensions with the Wix CLI

## Article Link: https://dev.wix.com/docs/build-apps/develop-your-app/develop-an-app-with-the-cli/supported-extensions/dashboard/external-links/add-external-url-extensions-with-the-wix-cli.md

## Article Content:

# 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](https://dev.wix.com/docs/build-apps/develop-your-app/extensions/dashboard-extensions/external-links/about-external-link-extensions.md).

## 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](https://dev.wix.com/docs/wix-cli/command-reference/project-commands/generate.md) command and follow the prompts to create an external URL extension:

   ```bash
   wix generate
   ```

   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:

```tsx
src
└── extensions
    └── dashboard
        └── external-page
            └── <your-extension-name>
                └── <your-extension-name>.extension.ts
```

> **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](https://dev.wix.com/docs/wix-cli/guides/project-structure/project-structure.md).

For more information about these files, see [External URL Extension Files and Code](https://dev.wix.com/docs/build-apps/develop-your-app/develop-an-app-with-the-cli/supported-extensions/dashboard/external-links/external-url-extension-files-and-code.md).

<blockquote class="important">

__Important:__ The external URL extension is registered in the dashboard only after you [release a new version of your app](#build-and-deploy-your-project). Until then, the extension won't appear in the Manage Apps page.

</blockquote>

## Build and deploy your project

Once your project is ready for production, you can [build and deploy](https://dev.wix.com/docs/build-apps/develop-your-app/develop-an-app-with-the-cli/project-development/build-and-deploy.md) 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](https://www.wix.com/app-market) or install it on a site with a direct install URL. You can view [your app's versions](https://manage.wix.com/app-selector?title=Select+an+App&primaryButtonText=Select+Site&actionUrl=https%3A%2F%2Fdev.wix.com%2Fapps%2F%7BappId%7D%2Fversions-app) 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`](https://dev.wix.com/docs/build-apps/develop-your-app/develop-an-app-with-the-cli/supported-extensions/about-the-extensions-ts-file.md) file.

<blockquote class="important">

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

</blockquote>

## See also

- [About External URL Extensions](https://dev.wix.com/docs/build-apps/develop-your-app/extensions/dashboard-extensions/external-links/about-external-link-extensions.md)
- [External URL Extension Files and Code](https://dev.wix.com/docs/build-apps/develop-your-app/develop-an-app-with-the-cli/supported-extensions/dashboard/external-links/external-url-extension-files-and-code.md)