> For the complete documentation index, see [llms.txt](https://docs.buildnatively.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.buildnatively.com/guides/integration/open-app-settings.md).
# Open App Settings
## What is Open App Settings?
Open App Settings sends the user directly to your app's system settings page - the screen where they can manage permissions like Camera, Location, Microphone, and Notifications for your specific app. This is useful when a user has denied a permission, and you want to give them an easy way to re-enable it without having to navigate through their device settings manually.
## Prerequisites
{% hint style="success" %}
This feature is available in all plans. [See all plans](/getting-started/subscription-plans.md)
{% endhint %}
## Implementation
Choose your integration method below: **Bubble.io Plugin** (No-Code), **JavaScript SDK** (Code), or **AI Agents** (for AI-powered editors like Lovable, Base44, and Replit).
### Initialization
{% tabs %}
{% tab title="Bubble.io Plugin" %}
**Check Plugin**
Before starting, verify if the Natively plugin is already installed in your Bubble project.
1. Open your Bubble editor and navigate to the Plugins tab in the left sidebar.
2. **Check Installed Plugins:** Look through your list of installed plugins for "Natively iOS & Android app builder".
* If it IS installed: Check the version number. If an update is available (e.g., you see a button saying "Update"), click it to ensure you have the latest features and bug fixes.
* If it is NOT installed: Click the + Add plugins button, search for "Natively", and click Install.
{% endtab %}
{% tab title="JavaScript SDK" %}
**Check SDK**
Before writing any logic, ensure the Natively SDK is correctly installed and up-to-date in your codebase.
1. Open your project's main HTML file (or header settings) and look for the Natively script tag inside the `` section.
2. Install/Update: If missing or outdated, add the following code. You can specify the SDK version in the URL (e.g., `@2.26.0`).
```javascript
```
{% hint style="info" %}
To ensure you are using the most up-to-date version, check the [Natively GitHub releases page](https://github.com/buildnatively/js-sdk/releases) for the latest version number.
{% endhint %}
{% endtab %}
{% tab title="AI Agents" %}
**Initialize the SDK**
AI-powered editors like Lovable, Base44, and Replit use the JavaScript SDK to implement Natively features. Before implementing any feature, the Natively SDK must be initialized in your project.
Copy the line below and paste it into your AI agent to check and set up the Natively SDK in your project.
```
Check if the following Natively SDK script is present in the of index.html. If missing or outdated, add it: For reference: https://docs.buildnatively.com/guides/integration/how-to-get-started https://github.com/buildnatively/js-sdk/releases
```
{% endtab %}
{% endtabs %}
### Setup Logic
{% tabs %}
{% tab title="Bubble.io Plugin" %}
#### \[Action] Natively - Open App Settings
Opens the device's system settings page for your app. No parameters required.
{% endtab %}
{% tab title="JavaScript SDK" %}
```javascript
// ============================================================================
// NATIVELY OPEN APP SETTINGS - DOCUMENTATION & EXAMPLES
// ============================================================================
// No initialization required — openAppSettings is available directly
// on the global window.natively object.
// ============================================================================
// ALL AVAILABLE METHODS
// ============================================================================
// window.natively.openAppSettings()
// - Opens the device's system settings page for your app.
// - No parameters required. No callback.
// --- Open App Settings. Example. Start ---
window.natively.openAppSettings();
// --- Open App Settings. Example. End ---
```
{% endtab %}
{% tab title="AI Agents" %}
AI-powered editors like Lovable, Base44, and Replit use the JavaScript SDK to implement Natively features.
Copy the line below and paste it into your AI agent.
[Your feature description] using the Natively Open App Settings SDK: // window.natively.openAppSettings() — opens the device's system settings page for your app. No parameters or callback required. For reference: https://docs.buildnatively.com/guides/integration/open-app-settings
{% hint style="warning" %}
Replace the placeholder at the beginning with a description of what you want to build - for example: "Add a button that opens the app settings when the user has denied camera permission".
{% endhint %}
{% endtab %}
{% endtabs %}
### How to use
#### Redirect after a denied permission
The most common use case is showing a prompt when a user has denied a permission - Camera, Location, Microphone, Notifications - and offering them a button to go directly to settings to re-enable it. This is much better UX than asking the user to find the settings themselves.
#### Don't open settings without context
Always explain to the user why you're sending them to settings before triggering `openAppSettings()`. A clear message like "Camera access is required to scan QR codes. Please enable it in your app settings." prevents confusion.
#### Pair with permission status checks
Use feature-specific permission checks to detect when a permission is denied before showing the settings prompt. Only surface the button when it's actually needed.
## Troubleshooting
Nothing happens when openAppSettings() is called
Make sure the feature is triggered from a user interaction - like a button tap - rather than automatically on page load. Also verify the SDK is fully loaded before calling the method.
Not working in a web browser
This is a native feature and will not work in a standard web browser. Test on a real device using a Natively build or the Preview app.
Opens the wrong settings screen
`openAppSettings()` opens the system settings page specifically for your app - not a general settings menu. If the user is being taken to an unexpected place, verify you are using the correct method and not `openExternalURL` pointing to a settings URL.
[^1]: Replace this placeholder
