launch url

Launches a url in the appropriate manner for the current system.

# Metadata

Platforms: desktop, mobile OS: mac, windows, linux, ios, android Introduced: 2.9 Security: process

# Syntax

launch url urlToLaunch

# Params

- urlToLaunch : The <URL(glossary)> to launch.

# Examples

launch url "http://www.livecode.com"

launch url "file:/Users/ben/Desktop/test.pdf"

launch url "tel:44 7818 8822"

# Description

Use the launch url command to open a url using the default action for the current system. The command performs an action appropriate to the protocol and address provided in the given URL.

The following url schemes are supported:

- `http:` and `https:` URLs, which launch in the default browser application if available - `file:` URLs, which open the file in the associated application - `tel:` URLs, which open the dialer with a given phone number

>*Note:* The urlToLaunch must be a standards-compliant URL. In > particular, `file:` URLs must be of the form `file://absolute path`, > and the path should be URLEncode.

>*Important:* Mobile: Successfully launching a url will cause another > application to open and the requesting application to be quit. The > application will receive a shutdown message before this happens.

>*Android:* files in specialFolderPath("engine") and specialFolderPath("resources") > cannot be accessed via launch url.

# Tags

# See

- **keyword:** URL - **command:** revGoURL, launch, launch document - **function:** URLEncode - **glossary:** URL, URL scheme