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

# openUrl

> Opens an external URL

Opens an external URL.

If a user is on mobile `openUrl` can be used to deeplink
users into different parts of the Farcaster client they
are using.

<img src="https://mintcdn.com/neynar/Uxa-Ieom0HVNjtON/miniapps/open_url_preview.png?fit=max&auto=format&n=Uxa-Ieom0HVNjtON&q=85&s=d96903f10a36be05f1d73cbb185c493c" alt="opening a url" width="1756" height="1194" data-path="miniapps/open_url_preview.png" />

*Opening an external url with `openUrl`.*

## Usage

```ts theme={"system"}
import { sdk } from '@farcaster/miniapp-sdk'

const url = 'https://farcaster.xyz';

// Pass URL as a string
await sdk.actions.openUrl(url)

// Or pass URL as an object
await sdk.actions.openUrl({ url: 'https://farcaster.xyz' })
```

## Return Value

`void`


## Related topics

- [Specification](/miniapps/specification.md)
- [Host Farcaster Mini Apps — Overview](/docs/app-host-overview.md)
- [openMiniApp](/miniapps/sdk/actions/open-miniapp.md)
- [Open invites](/reference/fetch-channel-invites.md)
- [HTML & OpenGraph Metadata in Mini Apps](/docs/html-metadata-in-frames-and-catalogs.md)