⚙️Settings

Do not forget to save your changes and rebuild your app.

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.

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:[email protected])

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.

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.

iPad support [Only for iOS]

• Select devices that you want to be supported

• iPhone, iPad or both

• Android tablets are supported by default

If your previously submitted version included iPad support, it's crucial to keep this setting consistent in subsequent builds.

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:

2.1. Bubble: "Natively - Reload WebView" action.

2.2. JS SDK: window.natively.reloadWebview();