🔍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. // TODO: ADD URL TO THE PAGE

• 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:

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

• Join our community in Discord and ask your question at the #support 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 [email protected]

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.