> 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: External URL Extension Files and Code

## Article: External URL Extension Files and Code

## Article Link: 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

## Article Content:

# External URL Extension Files and Code

When you generate an external URL extension, the CLI adds a `<your-extension-name>.extension.ts` to your project that contains the external URL builder configuration.

## External URL builder

The `<your-extension-name>.extension.ts` file contains an external URL builder configuration.

Here's an example builder definition:

```ts
export default extensions.dashboardExternalPage({
  id: 'b2f3c4d5-e6f7-4a8b-9c0d-1e2f3a4b5c6d',
  url: 'https://example.com',
});
```

### Builder fields

The following fields can be used in the configuration object:

| Field | Type | Description |
|--|--|--|
| `id` | string | Extension ID as a [GUID](https://en.wikipedia.org/wiki/Universally_unique_identifier). It must be unique across all extensions in the app. |
| `url` | string | Your external service's address. When a site collaborator opens your app from the Manage Apps page in their site dashboard, their browser opens this address in a new tab. For security reasons, you must host your app on an `https` address. |