What are the requirements for adding images or banners to push notifications?

To add an image or banner to your push notification you need a direct URL to the image file. The simplest way to get one is Pushwoosh's built-in Media store.

Option 1 — Use the Media store (recommended)

Go to Content > Media store in the Control Panel and upload your image. You can then reuse it across push notifications, web push, emails, in-app messages and Cloud Pages, either directly in the editor or via its stable URL.

• Accepted formats: JPG, PNG, WebP and GIF. Other file types are ignored.
• Size limits: up to 5 MB for JPG, PNG and WebP; up to 10 MB for GIF.
• You can upload up to 5 images at once, and create resized/cropped variants at a chosen aspect ratio for different placements.

See Media store.

Option 2 — Host the image yourself

1. Public accessibility: the image URL must be publicly accessible via a direct link — anyone with the link can view it without logging in or authenticating.
2. Reliable hosting: if you are sending to a large audience, use hosting that can absorb many simultaneous requests right after the push goes out. A Content Delivery Network (Amazon S3 with CloudFront, Google Cloud Storage, Cloudflare R2 or similar) is recommended for performance and reliability.

Dimensions and formats per platform

• Android: there is no single required resolution or aspect ratio — Android scales and crops as needed. Around 1000×1000 px works well; above 2000×2000 px is not recommended. JPEG and PNG are supported, a file size up to about 1 MB keeps downloads fast, and 2:1 is a common ratio (16:9 and square are fine too).
• iOS (iOS 10+ media attachments): images (JPEG, PNG, GIF) up to 10 MB, video up to 50 MB, audio up to 5 MB. Rich notifications integration must be implemented in your app.

File size and quality: stay within the platform limits and balance image quality against file size so images load quickly for users.

Testing: always send a test notification to a real device to verify the image displays correctly before sending to your broader audience.