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

# Troubleshooting

<details>

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

The first thing you must go through this checklist:&#x20;

* [ ] If you're using the **Natively Preview** app, you must [set the 'preview' tag in plugin](../natively-platform/preview) settings. **IF NOT,** you need to leave it blank.
* [ ] [After you've enabled and set up Push, you need to rebuild your app.](../natively-platform/app-info)
* [ ] [Make sure you've enabled](../../natively-platform/features/notifications/onesignal-notifications#enable-push-notifications) & [set up Push for your app.](../setup-one-signal-app#video-guide)
* [ ] [Double-check your bubble app setup](../integration/push-notifications-onesignal#bubble-setup-push-example)
* [ ] [Network issue](https://documentation.onesignal.com/docs/notifications-show-successful-but-are-not-being-shown#network-issues)
* [ ] [Not targeted push (missing/wrong PlayerID)](https://documentation.onesignal.com/docs/notifications-show-successful-but-are-not-being-shown#not-targeted-in-the-push)
* [ ] [App Push Permission](https://documentation.onesignal.com/docs/notifications-show-successful-but-are-not-being-shown#app-push-permissions-disabled---device-not-subscribed)
* [ ] [Android Category](https://documentation.onesignal.com/docs/notifications-show-successful-but-are-not-being-shown#android-categories-disabled)
* [ ] [Low power mode](https://documentation.onesignal.com/docs/notifications-show-successful-but-are-not-being-shown#low-power-energy-saving)
* [ ] [Do not disturb mode](https://documentation.onesignal.com/docs/notifications-show-successful-but-are-not-being-shown#do-not-disturb-mode)
* [ ] (For iOS) [Sometimes you need to re-generate the PUSH certificate](generate-ios-push-key) 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)

</details>

<details>

<summary>Deeplinks doesn’t work in the Android/iOS app</summary>

The first thing you must go through this checklist:&#x20;

* [ ] 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.](../natively-platform/app-info)
* [ ] [Make sure you've enabled ](../natively-platform/features/deeplinks)& [set up Deeplinks for your app.](setup-website-universal-links-deeplinks)
* [ ] [Double-check your bubble app setup](setup-website-universal-links-deeplinks)
* [ ] (For iOS) Validate your website [here](https://branch.io/resources/aasa-validator/)
* [ ] [(For Android) Make sure you have added assetlinks.json](../setup-website-universal-links-deeplinks#setup-your-bubble.io-website)
* [ ] 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](https://stackoverflow.com/a/40687167)
* [ ] Sometimes Apple/Google takes up to 48h to update the associated domain
* [ ] Sometimes reinstalling the app helps (Delete app → Reboot phone → Install app)

</details>

<details>

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

The first thing you must go through this checklist:&#x20;

* [ ] 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.](../natively-platform/app-info)
* [ ] [Make sure you've enabled](../../natively-platform/features/purchases#how-to-set-up-purchases) & [set up In-App for your app.](../setup-revenuecat-app#video-guides)
* [ ] [Double-check your bubble app setup](../integration/in-app-purchases#bubble-setup-example)
* [ ] 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](https://community.revenuecat.com/sdks-51/why-are-offerings-or-products-empty-124)&#x20;
* [ ] Sometimes Apple/Google takes up to 24h to update the purchases setup
* [ ] Sometimes reinstalling the app helps (Delete app → Reboot phone → Install app)

</details>

<details>

<summary>I have a problem with a different Native feature</summary>

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](https://discord.gg/KwtHeTAsjN) and ask your question at the #support channel.
* [ ] Check out our [editor test/example app](https://bubble.io/page?type=page\&name=purchases\&id=nativelyqa\&tab=tabs-1) on bubble. It has a separate page for each native feature.

</details>

## 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](testing-and-submitting-your-app)
2. [In-App purchases rejection](https://www.revenuecat.com/docs/app-store-rejections)
3. [Google Policy violation](http://www.androidb.com/2015/11/your-app-was-rejected-for-violating-googles-policy-now-what/)\


### 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](https://forum.bubble.io/t/data-on-page-not-getting-updated/183223/29) thread on the bubble forum.

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

<figure><img src="https://3352617162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F90tV7pYflEQdiAr2VfWu%2Fuploads%2F0YlTSyqOPYSPHl1c8pWx%2Ferror_agreement.png?alt=media&#x26;token=21f16d79-def4-446b-a5da-f1f2e22532d1" alt=""><figcaption></figcaption></figure>

Go to your [App Store Connect](https://appstoreconnect.apple.com) and follow the instructions provided in the yellow banner at the top of the page.

<figure><img src="https://3352617162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F90tV7pYflEQdiAr2VfWu%2Fuploads%2FPp1MpXfji2BSQekSchom%2FScreenshot%20from%202025-01-08%2011-28-46.png?alt=media&#x26;token=31e82668-8163-4c3c-bdd5-1e32a107c864" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3352617162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F90tV7pYflEQdiAr2VfWu%2Fuploads%2FgoWgu1tGUrdlYKXiIpvf%2Ferror_version.png?alt=media&#x26;token=3ffbe3b3-8b41-4a5b-b07f-833784695cf9" alt=""><figcaption></figcaption></figure>

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/](https://semver.org/)

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

{% hint style="info" %}
If you still have any issues, contact us on support chat or by email at support@buildnatively.com
{% endhint %}



