> 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/hidden-pages/onesignal-notifications.md).

# OneSignal Notifications

{% hint style="warning" %}
This page is no longer being updated. Please refer to our [Push Notifications - OneSignal](/natively-platform/features/notifications/onesignal-push-notifications.md) for current configurations and support.
{% endhint %}

[Notifications](https://developer.apple.com/design/human-interface-guidelines/ios/app-architecture/accessing-user-data/) can give people timely and important information, whether the device is locked or in use. For example, notifications can signal when a message arrives, an event is about to occur, or there’s a status change.

To configure your app to work with push notifications, you need to do the following steps:

1. [Setup OneSignal App](/hidden-pages/setup-one-signal-app.md)
2. Enable the Push Notification feature.&#x20;
3. Enter all relevant push notification information in the Natively dashboard.
   1. **(Only for iOS) Permission description** - The permission description text should explain to the user why your app needs that permission. Refer to [**Apple's guidelines** ](https://developer.apple.com/design/human-interface-guidelines/ios/app-architecture/accessing-user-data/)to avoid potential **rejection**.
   2. **One Signal App Id** - App ID used by the One Signal service to send push notifications.
   3. **(Optional) Push Auto Register (v2.12.0) -** Automatically calls Push Notification permission on app launch
   4. **Custom Notification Sound** - can be used later to send push with custom sound.
4. **(Only for iOS)** Enable "Push Notification" capabilities for your App.
   1. Go to the [Apple Developer Identifiers](https://developer.apple.com/account/resources/identifiers/list) -> Find your app's Bundle ID. Click on it<br>

      <figure><img src="/files/YvJd4by0n8ztvXNTKSXQ" alt=""><figcaption></figcaption></figure>
   2. &#x20;Scroll down and enable "Push Notifications". Click Save.<br>

      <figure><img src="/files/3BijlPzrh8LrsypA4j3I" alt=""><figcaption></figcaption></figure>
5. Rebuild your application

{% hint style="warning" %}
If you have 2 apps (iOS and Android) for 1 website, you need **1** OneSignal application with 2 platforms enabled.
{% endhint %}

## How to use Push Notifications?

{% content-ref url="/pages/k9MsZswnHE6zIyEKzAn0" %}
[OneSignal - Push Notifications](/natively-platform/features/notifications/onesignal-push-notifications.md)
{% endcontent-ref %}
