Image isn't showing in push notifications

Custom notification handler is used, or image downloading isn't implemented

How to check

Review your onMessageReceived implementation and compare it against the setup instructions for Push Notifications Setup for Firebase guide.

If your implementation differs from what's documented and you can't use the Mindbox handler, the image rendering will need to be debugged on your end. Use the default function implementation as a reference.

How to fix

Update your onMessageReceived to match the Push Notifications Setup for Firebase guide, or implement image downloading logic yourself based on the default function.

Image exceeds the 5 MB size limit

How to check

Download the image using the URL from the campaign and check its file size.

How to fix

Replace the image in the campaign with a smaller one and run the test again.

Image renders as a broken link

This usually means the image wasn't uploaded to Maestra — it's referenced by URL but can't be fetched.

How to check

Open the image URL from the campaign directly in a browser and confirm it loads.

How to fix

Try a different image, or upload the original directly to Maestra.

Image format isn't JPG or PNG

How to check

Open the image URL from the campaign in a browser and confirm the file format.

How to fix

Replace the image with one in JPG or PNG format.

⚠️

Heads up

Only jpg and png formats are supported for push notification images. Other formats (e.g., webp, gif, svg) won't render correctly.