> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hyperwisor.com/llms.txt
> Use this file to discover all available pages before exploring further.

# URL Button

> A button that opens an external URL.

<Info>
  **Category:** Navigation · **Opens:** an external link
</Info>

## Mental model

A **URL Button is an external link.** Press it to open a web address — docs, a store
page, a support site — optionally in a new tab.

## When to use it

* Link out to an external site or resource
* A "buy," "support," or "learn more" button

## Settings

### General / Style

* **Target URL** — the link to open
* **Open in new tab**
* **Button text** · **icon** · **icon position** · **variant** · **size**
* **Show label / icon / container**
* Background / border / text color · padding

## Script API example

The same interactions from a [dashboard script](/script/overview):

```js theme={null}
// Count outbound clicks
widget.on('shopBtn', 'click', () => {
  storage.set('shop_clicks', (storage.get('shop_clicks') || 0) + 1);
});
```

<Card title="Navigate Page" icon="arrow-right" href="/dashboard/widgets/navigate-page">
  For internal dashboard pages.
</Card>