# Link Menu to an External URL

ONEWEB allows you to link a **menu item to an external URL**, enabling users to access external websites or web applications directly from the application menu.

This approach is useful when you want to integrate third‑party systems, documentation portals, or external services into your application’s navigation.

***

### Steps to Link a Menu to an External URL

Follow the steps below to configure a menu item that opens an external link.

***

#### Open Menu Configuration

1. Navigate to the **Menu Configuration** screen.
2. Select the appropriate **hierarchical position** where the menu item should appear.
3. Click the **Menu icon** to open the **Menu Properties** screen.

***

#### Define Menu Properties

In the **Menu Properties** screen:

1. Enter values for:
   * **Description** – the display name shown in the menu
   * **Sequence** – the position of the menu item within the menu hierarchy
2. In the **Action URL** field, enter the **full external URL** you want to open\
   (for example, `https://www.example.com`).

***

#### Configure Menu Type

1. Set the **Type** field to **PAGE**.
2. Verify that the Action URL correctly points to the external destination.

<figure><img src="https://2015371994-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMpDjHWFRUtZ5nJcSfVXd%2Fuploads%2F9pIhX0q9tuj7WVayBYDr%2F1?alt=media" alt=""><figcaption></figcaption></figure>

3. Click **OK** to save the menu properties.

***

#### Save and Apply Changes

1. On the **Menu Configuration** screen, click **Save Menu**.
2. Log out of ONEWEB.
3. Log in again to reload the updated menu configuration.

The external URL menu item is now active and ready for use.

***

### Result

After completing the configuration:

* The menu item appears in the selected position
* Clicking the menu opens the external URL
* Navigation behaves like other PAGE‑type menu items
* Users can seamlessly access external resources from within the application

***

{% hint style="info" %}
**Note**:\
Ensure that **Cross‑Origin Resource Sharing (CORS)** is properly enabled on the target website.\
This is required for the external URL to load correctly within the application context.
{% endhint %}

***

### Summary

Linking a Menu to an External URL enables:

* Seamless integration with third‑party systems
* Easy access to external resources from within the application
* Consistent navigation experience using the ONEWEB menu framework

By using **Type = PAGE** and specifying a full external URL, applications can extend navigation beyond the ONEWEB platform while maintaining a unified user experience.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.onewebstack.com/building-apps/ui-page-designer/ux-ui-components/menu-and-navigation/link-menu-to-an-external-url.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.