For the complete documentation index, see llms.txt. This page is also available as Markdown.

How to send a test push notification to your mobile?

You can add a test device and target it from the dashboard to ensure your notification is displayed correctly.

Batch allows you to find information on your installation and test your integration or make sure the notification you are editing works as expected on a real device (deeplink, image, mobile landing, etc).

The easiest way is to use either your Installation ID (iOS/Android) if it is displayed in your app, your Custom ID (iOS/Android) if it is sent to Batch, or the email address linked to the profile if there is one. Once you retrieve your ID, go to point 2.

1. Locate your Installation ID

💡 From version 1.18 of our SDK, you can find your Installation using the "Find my Install" feature.

Batch will copy the Installation ID to the clipboard when the application appears in the foreground 4 times within 20 seconds.

2. Find your device

On the dashboard, go to Data > Find Profile, and paste your ID (with the correct ID type selected):

In the Platforms section, find your device and click on Inspect:

This opens the device pop-in, which shows the information Batch has on your device. From this pop-in, you can send a test push and save the device as a test device:

3. Send a test notification

You can send a test notification from 2 places:

a) From the device pop-in

In case you just need to test your integration, open the device pop-in (see step 2) and click Send test push. Batch sends a test notification to this device.

b) From the message editor

To see how your own notification looks on your device, send a test from the message editor. You can send a test two ways:

  • Click on Send Test > Saved recipients and select the recipient you want to send the test to, then hit Send test.

  • Click on Send Test > One-time recipient, choose the identifier type (Custom ID, Installation ID or Push Token), enter it in the corresponding field, then hit Send test:

4. Save your device as a test recipient

You can save a test device once and reuse it for every future test, instead of looking up its Installation ID or Custom ID each time. There are two ways to do it:

  • From the device pop-in in Data > Find Profile (see step 2): click Save test device.

  • From Settings > Channels > Push, under the Test recipients tab. Click New recipient, give it a name, and enter its Custom ID, Installation ID, or Push Token:

Recipients saved this way are available at the project level and can be selected directly when sending a test from the Push, In-App, or Mobile Landing message editor.

Last updated