🔍Troubleshooting

In this section, you can find guides that can help troubleshoot any Natively-related issue.

Push Notification doesn't work in the Android/iOS app

The first thing you must go through this checklist:

• If you're using the Natively Preview app, you must set the 'preview' tag in plugin settings. IF NOT, you need to leave it blank.

• After you've enabled and set up Push, you need to rebuild your app.

• Make sure you've enabled & set up Push for your app.

• Double-check your bubble app setup

• Network issue

• Not targeted push (missing/wrong PlayerID)

• App Push Permission

• Android Category

• Low power mode

• Do not disturb mode

• (For iOS) Sometimes you need to re-generate the PUSH certificate and re-upload it to OneSignal

• (For Android) Sometimes, Android pushes are not coming. You need to delete the app and install it one more time. (This issue will not appear after release to Store)

Deeplinks doesn’t work in the Android/iOS app

The first thing you must go through this checklist:

• Your custom links are not supported in the Natively Preview app, you need to build & setup your own app.

• After you've enabled and set up Deeplinks, you need to rebuild your app.

• Make sure you've enabled & set up Deeplinks for your app.

• Double-check your bubble app setup

• (For iOS) Validate your website here

• (For Android) Make sure you have added assetlinks.json

• Make sure file is available by 'yourdomain.com / .well-known / yourfile' (it shouldn't be anywhere else)

• Make sure you're opening a link that is associated with your domain, sometimes services like SendGrid have a redirect URL system

• Sometimes Apple/Google takes up to 48h to update the associated domain

• Sometimes reinstalling the app helps (Delete app → Reboot phone → Install app)

In-App Purchases doesn’t work in the Android/iOS app

The first thing you must go through this checklist:

• In-App Purchases are not supported in the Natively Preview app, you need to build & set up your own app.

• After you've enabled and set up In-App purchases, you need to rebuild your app.

• Make sure you've enabled & set up In-App for your app.

• Double-check your bubble app setup

• Check the Latest Error value from Natively Purchases element.

• Make sure Google/Apple products are Active / Ready to submit test

• Sometimes Apple/Google takes up to 24h to update the purchases setup

• Sometimes reinstalling the app helps (Delete app → Reboot phone → Install app)

I have a problem with a different Native feature

If you are faced with a problem related to a different native feature, go through this checklist:

• Almost all elements in the Natively bubble plugin have a Latest Error state, try to check its value. Usually, it helps to describe a problem.

• Join our community in Discord and ask your question at the #general-questions channel.

• Check out our editor test/example app on bubble. It has a separate page for each native feature.

FAQ

I'm seeing an error related to the Natively plugin when I try to use an action.

This usually happens when the plugin can't find the element it needs to trigger the action. Here are a few things to check:

• Visibility: Make sure the element associated with the action is placed on the page and is visible.

• Element Location: Don't place the element inside another element that might be hidden when you need to use the action (like a floating group, popup, focus group, or repeating group).

• Required Fields: Ensure all the required fields for the action are filled in. If you're using dynamic data, double-check that the values are not empty.

My app was rejected by App Store / Google Play

Often some apps are got rejected by App Store or Google Play. It's normal.

First, you need to read the reason for the rejection message and apply the action steps.

Many rejections from Apple/Google teams are related to inaccurate descriptions. It might be related to unclear permission texts, In-App purchases product descriptions, or event application descriptions in a store. Here you can find a few useful links that can help you fix the problem:

1. Release guide

2. In-App purchases rejection

3. Google Policy violation

After I close the app and then open it, data in RG are not updated (Chat case)

Unfortunately, we cannot handle this since it's a bubble socket issue. Check this thread on the bubble forum.

I'm seeing an error when I try to rebuild my app - new agreement is missing

Go to your App Store Connect and follow the instructions provided in the yellow banner at the top of the page.

I'm seeing an error when I try to rebuild my app - app version

This error appears when the app version in your Natively dashboard is lower then the app version in your App Store Connect > TestFlight. Or if the current version in your TestFlight is closed for new builds. If the app's version in TestFlight is 1.0.0, please provide version 1.0.1 (or higher) for a new build in your Natively dashboard. You can find more about app versioning in this article: https://semver.org/

Why am I seeing an error when I try to add my iOS credentials?

This error appears when some of the data you've provided is invalid or mismatched. The most common reasons for this are:

• The AuthKey either has an incorrect role (it must be App Manager), has been revoked, or is not associated with the provided Issuer ID.

• The Bundle ID you entered does not exist or is not associated with the Apple account the AuthKey is for.

• The Bundle ID is not correctly linked to the App Store App ID you provided.

Follow our guide on how to provide iOS credentials for a new app here: iOS App

My app opens a new tab of the internal browser on launch

This can occur when the website's actual domain doesn't match the App URL you provided in the Natively dashboard.

For example, if you set your App URL as https://subdomain.domain.com, but the website redirects to https://example.com upon opening, the app will recognize https://example.com as an external website. Since this domain isn't the one you initially specified as your App URL, it will open in a new tab within the app.

To resolve this, update the App URL in your Natively dashboard to reflect the actual domain your website uses. After saving this change, rebuild your app.

If you still have any issues, contact us on support chat or by email at [e-mail]

Why is my app screen horizontally scrollable?

This behavior occurs because there is an element on your webpage that is wider than the device's screen width.

For example, if the screen size is 390 pixels, but an element's minimum width is set to 391 pixels, the entire page will be forced to scroll horizontally.

Solution: You need to review the elements on your page to ensure they are fully responsive and correctly sized for smaller screens. This behavior originates within your website's design, not the app.

Why are users being logged out over time, or why do they keep seeing the login screen?

Natively does not manage user sessions, cookies, or login persistence; it simply renders your website and respects your website's settings. These issues are tied directly to the session management logic within your website.

1. Automatic Logout (Session Expiration)

If users are being logged out after a period of time, the issue is typically caused by your website's default session expiration settings. This needs to be adjusted within your website's settings.

2. Persistent Login Screen

If logged-in users keep seeing the login page on app launch:

• This happens if your app's main URL points directly to the login page.

• Solution: You must verify the user's session status on the login page. If the user is authenticated, set up an automatic redirect in your workflow to immediately send them to the home page.

The payment provider is not returning the user to the app via the Return URL

Please verify if your payment provider supports Universal Links for redirects. Some providers, such as Stripe, do not support this functionality (see Stripe Docs).

The Solution: The "Landing Page" Pattern Since standard HTTP redirects often fail to trigger Universal Links on iOS/Android, you need to create a landing page:

1. Set the payment provider's return URL to a specific page on your website (e.g., /success or /cancel).

2. On this page, place a button/link (e.g., "Return to App") that points to your Universal Link.

Note: The user must manually click this link. Browsers usually block automatic scripts attempting to open Universal Links without a user gesture.

I'm seeing an error related to the Natively plugin when I try to use an action in Bubble.

This usually happens when the plugin can't find the element it needs to trigger the action. Here are a few things to check:

• Visibility: Make sure the element associated with the action is placed on the page and is visible.

• Element Location: Don't place the element inside another element that might be hidden when you need to use the action (like a floating group, popup, focus group, or repeating group).

• Required Fields: Ensure all the required fields for the action are filled in. If you're using dynamic data, double-check that the values are not empty.

On iOS, the page zooms in when I tap an input field

This is a common behavior in iOS. To prevent this in Bubble, you can disable zooming in your app settings:

1. Go to your Bubble editor

2. Open the "Settings" tab

3. Click on "General"

4. Under "iOS appearance," check the box that says "Prevent the user from zooming"

5. Deploy to live to publish your changes

To prevent this in another web platform, add a CSS fix:

/* Target all common input elements to satisfy iOS accessibility guidelines */
input[type="text"],
input[type="number"],
input[type="email"],
input[type="search"],
input[type="password"],
textarea,
select {
  font-size: 16px !important;
}

What if Apple or Google rejects my app?

Usually, Apple/Google's team describes the reason for rejections. If you are pretty sure it's related to the source code of a mobile app build, please get in touch with support and attach relevant screenshots. Otherwise, it can be related to your website, or some data you've filled out on the App Store Connect/Google Play app page is inappropriate. In such a case, there is no obligation on the Natively platform to issue you a rebuild or refund.

How do I change my app (iOS or Android) Bundle ID (Bundle Identifier)?

The Bundle ID is the unique identity of your app and is locked upon creation.

We can perform a manual reset of your Bundle ID configuration only if your app or developer account has been suspended by Apple or Google.

To request this, please email [e-mail] and attach a screenshot of the official suspension notification from the store. The screenshot must include the App Name, Bundle ID (package name), or Account Name to verify the status.

For voluntary changes (rebranding, testing, etc.), you must create a new app in your Natively dashboard and activate a separate paid plan for it.

Why is my app loading slow? Is Natively blocking it?

From Natively's side, we are not doing anything to block your website from loading, and it's worth noting that app startup time can take 0.5-1s.

However, If you are using a single-page app approach and the user is logged in, the problem may lie there. In this case, we recommend splitting your app into several pages, such as combining login, signup, and onboarding on one page and settings on another. This should help improve the loading speed.

Why does the Android back button exit my app instead of going back?

The Android back button relies on your app's navigation history. If your website updates the URL as users move between pages or sections, the back button will correctly navigate back through that history.

However, if your website uses a different navigation method that doesn't change the URL (like single-page application routing without history updates, or dynamically loading content without URL changes), the native back button won't have a "history" to follow. In such cases, it defaults to simply exiting the app.

My document file does not display in the iframe on Android.

Unfortunately, Android WebView doesn't support iframe documents preview, you can use Natively's PDF Viewer feature instead.