The small image is not showing in the push notification

The image exceeds 5 MB

How to check

Download the image from your campaign and check its file size.

How to fix

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

The image displays as a URL and does not open.

This usually means the image was not uploaded to Maestra.

How to check

Open the image URL from your campaign and verify it loads.

How to fix

Try using a different image or uploading the original directly to Maestra.

The image is not in JPG or PNG format

How to check

Open the image URL from your campaign and verify it loads.

How to fix

Replace the image with one in JPG or PNG format.

Notification Service Extension is not implemented

How to check

Verify that you completed Displaying an image preview guide.

How to fix

Follow Displaying an image preview guide to implement the Notification Service Extension.

App Groups are not configured in the Service Extension

How to check

Verify that you completed Displaying an image preview guide. Check the .entitlements file — it shows the App Group value that was entered.

How to fix

Set the App Group exactly as specified in the Displaying an image preview guide.

The Service Extension is missing the image download code

How to check

Verify that your extension code matches Displaying an image preview guide. If it doesn't, you have a custom extension implementation that the Maestra team cannot debug.

How to fix

Use the reference implementation from the guide. If you keep a custom implementation, your team will be responsible for maintaining it.