# Settings

## General App Info

### App Name

The name of your application. Will be displayed on a device.

### App Url

The URL of your website that runs inside of your application.

{% hint style="info" %}
If your app is password protected (and it's not displayed in the app), please use the following formatting for your URL\
https\://{username}:{password}@yourwebsiteurl.com (example: <https://roman:123456@yourwebsiteurl.com>)
{% endhint %}

### External App Schemes

These app schemes will allow to open external apps from yours. \
Write the scheme in the input and click the 'Add' button.

<figure><img src="/files/FfcMbKI7xBp9FWwLX6GB" alt=""><figcaption></figcaption></figure>

### Internal URLs

Keep trusted third-party domains (like your own Help Center) inside your app’s primary view. This removes the "browser" UI (navigation bars) and makes external content feel like a native part of your app.

By default, Natively will open external domains in an In-App Browser to protect the user's session. However, you can force specific external URLs to open within your app’s primary view (without the navigation bar or "Close" ison) by using the whitelist.

How to whitelist a domain:

1. Navigate to your Natively Dashboard.
2. Go to Settings.
3. Locate the Internal URLs section.
4. Add the domains you want to keep internal (e.g., `*.example.com`).

When to use this:

* If your app logic spans multiple subdomains (e.g., `app.example.com` and `auth.example.com`).
* If you use a third-party service that must stay within your app context.

Examples:

* \*.example.com matches app.example.com
* example.\*.com matches example.dev.com
* *\*.\**.example.com matches api.dev.example.com

\
Write the URL/Domain in the input and click the 'Add' button.

<figure><img src="/files/b9Y014H6IKlwtji5pS3f" alt=""><figcaption></figcaption></figure>

## iPad support \[Only for iOS]

* Select devices that you want to be supported
* iPhone, iPad or both
* **Android** tablets are supported by default

{% hint style="info" %}
If your previously submitted version included iPad support, it's crucial to keep this setting consistent in subsequent builds.
{% endhint %}

## Reload WebView \[Advanced]

Reload the WebView after a period in the background or screen lock, or manually trigger a reload.

1. Enable the feature, set time interval (seconds), save, and rebuild.
2. Manual reload:

&#x20;      2.1. Bubble: "Natively - Reload WebView" action.&#x20;

&#x20;      2.2. JS SDK: window\.natively.reloadWebview();


---

# 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.buildnatively.com/natively-platform/settings.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.