Skip to content

Message format

This reference article describes message and image formats for iOS and Android push notifications.

iOS

  • Message Length:
    • iOS Lock Screen: 110 Characters
    • iOS Notification Center: 110 Characters
    • iOS Banner Alert: 62 Characters
    • iOS Pop Up Alert: 235 Characters
  • Payload Size:
    • iOS: 2 KB
  • Number of Lines:
    • iOS Lock Screen: 4 Lines
    • iOS Notification Center: 4 Lines
    • iOS Banner Alert: 2 Lines
    • iOS Pop Up Alert: 8 Lines
  • Customizable UI: No
  • Deep Link Capable: Yes
Aspect Ratio Recommended Image Size Maximum Image Size File Types
2:1 (recommended) 500 KB 5 MB PNG, JPG, GIF

iOS push notification with text that reads: "Hi! This is an iOS Push".

iOS push notification with text that reads: "Hi! This is an iOS Push with an image" with an emoji. There is a small image beside the text. iOS push notification on a hard push with the same text as the previous message with an expanded image preceding the text.

Android

  • Message Length:
    • Lock Screen: 1 line (estimated 49 characters max)
    • Notification Drawer: 1 line, up to 8 lines when expanded (estimated 597 characters max)
  • Payload Size:
    • FCM: 4 KB
  • Customizable UI: Yes
  • Deep Link Capable: Yes

Push icon

Aspect Ratio Recommended Image Size Maximum Image Size File Types
1:1 (400x400 pixels minimum) 500 KB N/A - however a balance should be struck between quality and size PNG, JPG

Expanded notification image

Aspect Ratio Recommended Image Size Maximum Image Size File Types
2:1 (600x300 pixels minimum) 500 KB N/A - however a balance should be struck between quality and size PNG, JPG

Android push notification displayed on the home screen.

Android push notification with a large image under the message text.

  Edit this page on GitHub
WAS THIS PAGE HELPFUL?
New Stuff!