> For the complete documentation index, see [llms.txt](https://docs.appfarm.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.appfarm.io/library/action-nodes/open-url.md).

# Open URL

The Open URL Action Node can be used to

* Opening external URLs / links
* Opening another App / internal URL
* Downloading files

{% hint style="info" %}
Showroom: [Open URL example](https://showroom.appfarm.app/action-nodes/open-url), with its setup in Appfarm Create ([register](https://showroom.appfarm.app/sign-up) for access).
{% endhint %}

## Properties

| Property             | Description                                                                                                                                                                                                                                                  |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **URL**              | The URL to open. For an external site, include `https://` (or `http://`). Relative URLs such as `my_other_subview` and domain-relative URLs such as `/my_other_app` open on the current domain. If the URL is empty, the node fails with "URL has no value". |
| **Query parameters** | Optional parameters to add to the URL.                                                                                                                                                                                                                       |
| **Open in**          | Where to open the URL: `Open in new` (default) opens a new browser tab or window, `Open in same` opens it in the current one.                                                                                                                                |

### Open external URLs / links

Apply the URL in setting **URL**. Optionally, you may add parameters to the URL using the **Query parameters**. External URLs are normally opened with **Open in** set to `Open in new`, which is the default.

### Open another App

In this case, you may refer to the App URL without a full hostname in the URL. For example, when opening another app with a readable ID `company-administration`, you may simply set the **URL** setting to `/company-administration`. The normal case for such navigation is to open in the same window, so set **Open in** to `Open in same`.

### Download files

In this case, you have a Data Source containing a file (document or image) you want to download. All File Object Classes in Appfarm have a built-in property **File Content**. As you may have noticed, the **Data type** of this property is an **Internet URL**. In the Open URL action node, you may simply data-bind to **File Content** property of your Data Source to the **URL** setting. You would typically use `Open in new`, but in most browsers, it will just download the file regardless of this setting.

A file that is not saved yet, for example a new file object in a runtime-only data source, is downloaded directly with its original file name.

In an app run from the iOS or iPadOS home screen, `Open in new` with **File Content** downloads the file instead of opening it. If the file does not respond within 30 seconds, the file URL opens in the current window instead.

### Login with custom authentication

Open URL may also be used when you want to log in with an external identify provider. Having a [Custom Auth Provider](https://docs.appfarm.io/reference/configuration/login/custom-auth-providers.md) added in Appfarm Create, and you may use the URL found in the blue dot of the Hide Login Button setting. This is explained [here](https://docs.appfarm.io/reference/configuration/login.md#custom-auth).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.appfarm.io/library/action-nodes/open-url.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
