⚙️Open App Settings

Direct users to your app's system settings page on their device.

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

This feature is available in all plans. See all plans

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

Check Plugin

Before starting, verify if the Natively plugin is already installed in your Bubble project.

Open your Bubble editor and navigate to the Plugins tab in the left sidebar.
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.

Check SDK

Before writing any logic, ensure the Natively SDK is correctly installed and up-to-date in your codebase.

Open your project's main HTML file (or header settings) and look for the Natively script tag inside the <head> section.
Install/Update: If missing or outdated, add the following code. You can specify the SDK version in the URL (e.g., @2.26.0).

<head>
  <script async onload="nativelyOnLoad()" src="https://cdn.jsdelivr.net/npm/natively@2.26.0/natively-frontend.min.js"></script>
</head>

To ensure you are using the most up-to-date version, check the Natively GitHub releases page for the latest version number.

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 <head> of index.html. If missing or outdated, add it: <script async onload="nativelyOnLoad()" src="https://cdn.jsdelivr.net/npm/natively@2.26.0/natively-frontend.min.js"></script><script>function nativelyOnLoad() { window.natively.setDebug(true); console.log("✅ Natively SDK loaded successfully."); }</script> For reference: https://docs.buildnatively.com/guides/integration/how-to-get-started https://github.com/buildnatively/js-sdk/releases

Setup Logic

[Action] Natively - Open App Settings

Opens the device's system settings page for your app. No parameters required.

// ============================================================================
// 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 ---

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

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".

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.

PreviousOpen External App NextPDF Viewer

Last updated 17 days ago