# Push Notification in Page

**Push Notification** allows an application to send **real‑time notifications to users’ mobile devices** through an installed application, similar to notifications received from apps such as LINE, Facebook, or Instagram.

Push Notifications work on both **Android** and **iOS**, as long as:

* The application is installed on the device
* The user has granted permission to receive notifications

Unlike **Local Notifications**, Push Notifications are:

* Triggered by **server‑side logic**
* Delivered even when the application is not running
* Commonly used for real‑time alerts and system events

***

### Key Characteristics

* Real‑time, server‑triggered notifications
* Delivered via the installed mobile application
* Requires internet connectivity
* Uses **Firebase Cloud Messaging (FCM)**
* Integrated with ONEWEB using **Microflow Push Notification node**

***

### Enable Push Notification Plugin

Before push notifications can be used, the **Push Notification plugin** must be enabled in Page Designer and configured with Firebase settings.

#### Step 1: Open Plugin Configuration

Open Page Designer and navigate to the plugin configuration area to enable Push Notification support.

*Enable Push Notification plugin*

<figure><img src="https://2015371994-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMpDjHWFRUtZ5nJcSfVXd%2Fuploads%2FEErNTBqFwXFBSL0p4525%2Fimage.png?alt=media&#x26;token=16911570-1e55-4680-9d77-c8c71d6a566c" alt=""><figcaption></figcaption></figure>

*Push Notification plugin configuration screen*

<figure><img src="https://2015371994-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMpDjHWFRUtZ5nJcSfVXd%2Fuploads%2FIw3ChI3A6O1K6uiJccFt%2Fimage.png?alt=media&#x26;token=62e614cb-5278-49da-b55c-8349b0f2326a" alt=""><figcaption></figcaption></figure>

*Upload Firebase configuration (Google Services)*

<figure><img src="https://2015371994-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMpDjHWFRUtZ5nJcSfVXd%2Fuploads%2FRK3RMLJ7lJqJnrjMF6W5%2Fimage.png?alt=media&#x26;token=09e8f018-08ce-49b6-a6ea-8db89cde5c40" alt=""><figcaption></figcaption></figure>

> You must upload the **Firebase Cloud Messaging (FCM)** configuration file\
> to enable push notifications for the application.

***

### Send Push Notification Using Microflow

Push Notifications are triggered from the **backend** using a **Microflow**.

ONEWEB provides a dedicated **Push Notification node** inside Microflow Designer.

***

#### Step 2: Configure Push Notification Node in Microflow

Inside a Microflow:

1. Add a **Push Notification node**
2. Configure required notification details, such as:
   * Notification title
   * Notification message/body
   * Target users or devices
   * Additional payload (if required)

<figure><img src="https://2015371994-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMpDjHWFRUtZ5nJcSfVXd%2Fuploads%2FYxVwtdKoTMPy65yE6qP0%2Fimage.png?alt=media&#x26;token=9247a822-880b-4d2c-8208-8ada54433074" alt=""><figcaption></figcaption></figure>

<p align="center"><em>Push Notification node configuration</em></p>

<figure><img src="https://2015371994-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMpDjHWFRUtZ5nJcSfVXd%2Fuploads%2FCP5jgfBhshqagY6nFdd3%2Fimage.png?alt=media&#x26;token=ef8325f6-eb05-463a-a5d1-4d3b64848e06" alt=""><figcaption></figcaption></figure>

<p align="center"><em>Notification payload and settings</em></p>

<figure><img src="https://2015371994-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMpDjHWFRUtZ5nJcSfVXd%2Fuploads%2F4g4afOP8CsVG2ha0cSSw%2Fimage.png?alt=media&#x26;token=c5d80868-8a16-491f-a60b-e6dce095a331" alt=""><figcaption></figcaption></figure>

<p align="center"><em>Target and delivery configuration</em></p>

<figure><img src="https://2015371994-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMpDjHWFRUtZ5nJcSfVXd%2Fuploads%2FdzC6d3CB1JlmI2jZncvp%2Fimage.png?alt=media&#x26;token=d4b8f403-7882-45c3-a7d6-0f00fca24e53" alt=""><figcaption></figcaption></figure>

<p align="center"><em>Final Push Notification node setup</em></p>

***

### Typical Use Cases

Push Notifications are commonly used for:

* Approval or workflow notifications
* Transaction status updates
* System or data change alerts
* User engagement and reminders

They are ideal when users must be notified **immediately**, even if the app is not open.

***

### Design Perspective

As part of **mobile app best practices** on ONEWEB:

* Use Push Notifications for **real‑time, server‑driven events**
* Use Local Notifications for **scheduled or offline reminders**
* Avoid over‑sending notifications to prevent user fatigue
* Always request and respect user notification permissions
* Clearly define notification purpose and content


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.onewebstack.com/building-apps/ui-page-designer/ux-ui-components/pages/page-features/push-notification-in-page.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.