# Add an App Inbox message to a push notification

> Create a push notification with the App Inbox channel under Marketing Channels › Push Notifications: write the inbox message, let the push open the inbox, set how long the message stays, and save it as a draft.

The **App Inbox** is a message centre inside your Android or iOS app. A push notification disappears once it is dismissed; an inbox message stays in the app until the shopper deletes it or it expires. You add an inbox message as a channel of a push notification: the push announces it, and a tap on the push can open the inbox. Saving sends nothing: the push and its inbox message are drafts until a workflow or campaign uses them. For how delivery, personalisation and expiry work, read [How the App Inbox works](https://releva.ai/documentation/learn/inbox/how-the-app-inbox-works/).

This guide creates an **Android** push with an **App Inbox** message. The same steps work with **IOS**, with both, or with **App Inbox** alone (an inbox-only message without a visible push).

## Before you start

* Your app uses a Releva mobile SDK and shows the inbox. See [Mobile SDKs overview](https://releva.ai/documentation/integrations/mobile/mobile-sdks-overview/).

* A developer added the Firebase service account of your app under **Settings › Messaging › Push Notifications**. The inbox is synced through Firebase, so **App Inbox** stays greyed out without it; see [Add your Firebase credentials for app push](https://releva.ai/documentation/integrations/mobile/add-firebase-credentials-for-app-push/).

  ![Android, IOS and App Inbox greyed out without Firebase credentials](https://releva.ai/documentation/_astro/step-1.CVW9WWgo_1ppXxY.webp)

* Your plan includes creating push notifications. If **New push Notification** shows a lock, ask your account owner to unlock it.

* You have the text of the push and the content of the inbox message, and any images are uploaded to your files.

## Steps

1. Go to **Marketing Channels › Push Notifications**

   ![Step 1](https://releva.ai/documentation/_astro/step-1.Cx-08R_L_rtM0N.webp)

2. Select **New push Notification**

   ![Step 2](https://releva.ai/documentation/_astro/step-2.albYzhfa_ZQo2aK.webp)

3. Enter a **Name**. Under **Channels**, clear **Web**, check the app platforms (here **Android**) and check **App Inbox**

   The tabs **Android** and **App Inbox** appear between **General** and **Behavior**. The name is only shown in Releva, but it must be unique among all push notifications in the shop.

   ![Step 3](https://releva.ai/documentation/_astro/step-3.PYDEJkL8_Z1op335.webp)

4. Select **Next**. On the **Android** tab, enter the **Subject** and the **Body** of the push that announces the inbox message

   Keep the push short and point to the inbox, for example “Open your inbox for the details.” An **Image URL** and **Button Text** are optional, as in [Create a mobile app push notification](https://releva.ai/documentation/guides/push-notifications/create-a-mobile-app-push-notification/).

   ![Step 4](https://releva.ai/documentation/_astro/step-4.ClTedOzk_1dwAnw.webp)

5. Select **Next**

   ![Step 5](https://releva.ai/documentation/_astro/step-5.Bl4mAvNx_ZsNT2E.webp)

6. On the **App Inbox** tab, enter the **Title** of the inbox message. Build the message below by dragging blocks such as **Heading** and **Button** from **Blocks** onto the message, and enter the button’s **Link**

   The **Title** is “Shown as the message header” and supports merge tags such as `{{firstName}}`; **Merge Tags** lists them. In the builder, you can also select a block to add it at the end, or start from **Templates**. Select a block on the message to change it in the panel on the right; a button needs a **Link**. The apps draw headings, text, images, buttons, dividers, spacers and carousels; other blocks show on the web only. **Preview** shows the message as the apps draw it and lists those blocks under **Not shown in the apps**.

   ![Step 6](https://releva.ai/documentation/_astro/step-6.Bgkxf8zm_1Wr8kg.webp)

7. Select **Next**

   ![Step 7](https://releva.ai/documentation/_astro/step-7.epz7LvEn_Z1vzJpA.webp)

8. Under **Push Delivery Options**, enter a **Tag** and set **Message Expire Time** in hours

   With **App Inbox**, **If max push notifications per day is reached** offers only **Send anyway** and **Skip sending**: **Reschedule** cannot be combined with the inbox, so the form switches to **Send anyway** when you check **App Inbox**. The other options are explained in [How push notifications work](https://releva.ai/documentation/learn/push-notifications/how-push-notifications-work/#notification-options).

   ![Step 8](https://releva.ai/documentation/_astro/step-8.NoenM8Wq_1YLzAh.webp)

9. Under **Mobile Targeting**, select **Open Inbox** so a tap on the push opens the inbox. Under **App Inbox**, set **Expiry (days)**, or leave it empty to keep the message

   **Open Inbox** is offered only while **App Inbox** is checked. You can also open the **Main Screen**, a **Specific Screen** or a **URL** instead. **Expiry (days)** accepts 1 to 365: “How many days to keep the message in the inbox. Leave empty for no expiry.” The expiry counts from the day each shopper receives the message.

   ![Step 9](https://releva.ai/documentation/_astro/step-9.Bi90MYZs_1gNqDW.webp)

10. Select **Save**

    **Save** stays disabled until the **App Inbox** tab has a **Title**, every checked push platform has a **Subject** and a **Body**, **Tag** and **Message Expire Time** are set, and no merge tag is broken.

    ![Step 10](https://releva.ai/documentation/_astro/step-10.HNo5RLdx_Z1Xg6Fh.webp)

11. Releva confirms that the push notification was saved. The push and its inbox message are drafts until you send them with a workflow

    Choose **Back To Listing**, **Continue Editing** or **Send it**; see [Send a push notification with a workflow](https://releva.ai/documentation/guides/push-notifications/send-a-push-notification-with-a-workflow/).

    ![Step 11](https://releva.ai/documentation/_astro/step-11.CKtZALmt_ZgPSya.webp)

## Check it worked

* The notification is the first card on the **Push Notifications** list with the badges **ANDROID**, **APP INBOX** and **MESSAGE**. Cards with **APP INBOX** also show **Inbox Sent**, **Inbox Reads** and **Inbox Clicks**, all 0 until it is sent.
* Open the notification and go to the **App Inbox** tab: your title and message are there, and a **Test** button now appears next to **Merge Tags**. **Test** delivers the inbox message to one profile, without a push. Use only your own test profile: a delivered inbox message cannot be recalled.

## Troubleshooting

**App Inbox is greyed out.** The shop has no Firebase credentials. A developer adds them under **Settings › Messaging › Push Notifications**; see [Add your Firebase credentials for app push](https://releva.ai/documentation/integrations/mobile/add-firebase-credentials-for-app-push/).

**Title is required.** The **Title** on the **App Inbox** tab is empty. Enter a title; **Save** stays disabled until you do.

**Invalid merge tag: Parse error on line 1.** A merge tag in the **Title**, **Subject** or **Body** is not closed, for example `{{firstName` without `}}`. Fix it or pick the tag from **Merge Tags**.

**Push Notification Name must be unique!** Another push notification in the shop already has this name, with or without an inbox message. Give the notification a different **Name**.

**There is no Test button on the App Inbox tab.** It appears only after the first save. Save, then select **Continue Editing**.

**There is no Reschedule option.** **Reschedule** is not available with **App Inbox**. Choose **Send anyway** or **Skip sending**.

**Open Inbox is missing under Mobile Targeting.** **App Inbox** is not checked under **Channels**. When you clear **App Inbox**, a target of **Open Inbox** is reset as well.

## Next steps

* [How the App Inbox works](https://releva.ai/documentation/learn/inbox/how-the-app-inbox-works/): Learn who receives an inbox message, when it expires and what read and delete mean.
* [Create a mobile app push notification](https://releva.ai/documentation/guides/push-notifications/create-a-mobile-app-push-notification/): Create another Android and iOS push with its own subject, body, image and tap target.
* [Send a push notification with a workflow](https://releva.ai/documentation/guides/push-notifications/send-a-push-notification-with-a-workflow/): Test your notification and hand it to a new or existing workflow to send it.
* [Inbox API overview](https://releva.ai/documentation/reference/inbox/overview/): Show the shopper’s inbox in your app, with a working request for each endpoint.