Content Limits

Limitations for Text Length

Rich push content text length limits vary depending on whether the payload includes an image.

Android

Mode	Type
	Text	Image
Notification panel collapsed	Title is one line only and gets truncated if too long. Body is also one line and gets truncated if too long. Title and body length varies from 20 to 55 characters, based on screen density.	The small image preview is shown center-cropped. Title is one line, and gets truncated if too long. Text body is one line, and gets truncated if too long. Title and text body length varies from 20 to 55 characters, based on screen density.
Notification panel expanded	Title length varies from 20 to 80 characters, based on screen density. Body length varies from 200 to 460 characters, based on screen density.	The image is shown in large. The preview image disappears. Title is one line, and gets truncated if too long. Text body is one line, and gets truncated if too long. Title length varies from 20 to 80 characters, based on screen density. Text body length varies from 20 to 90 characters, based on screen density.
Lockscreen	Expanded notifications are available as of API level 16. Title length varies from 20 to 55 characters, based on screen density. Text body length varies from 200 to 700 characters, based on screen density.
Heads up	Heads-up notifications are not supported.

Note

The notification text gets cropped if it's too long. There's no scrolling enabled. The exact character length limits also depend on the specific device.

Kotlin Multiplatform

Kotlin Multiplatform apps run on multiple platforms. The push notification content limitations depend on the platform the app is running on. Refer to the Android and iOS tabs for the platform-specific limits.

iOS

Mode	Text	Image
Notification center collapsed	Title is 1 line, and it’s truncated if too long. Character limit ~ 32. Body is 4 line and it’s truncated if too long. Character limit ~ 175 without picture.	The small image preview is shown on the right side. Title: 1 line and it’s truncated if too long. Character limit ~ 32. Body: 4 line and it’s truncated if too long. Character limit ~ 140.
Lockscreen collapsed	Title is 1 line, and it’s truncated if too long. Character limit ~ 32. Body is 4 line and it’s truncated if too long. Character limit ~ 175 without picture.	The small image preview is shown on the right side. Title: 1 line and it’s truncated if too long. Character limit ~ 32. Body: 4 line and it’s truncated if too long. Character limit ~ 140.
Floating collapsed	Title is 1 line, and it’s truncated if too long. Character limit ~ 32. Body is 4 line and it’s truncated if too long. Character limit ~ 175 without picture.	The small image preview is shown on the right side. Title: 1 line and it’s truncated if too long. Character limit ~ 32. Body: 4 line and it’s truncated if too long. Character limit ~ 140.
Expanded	Title: 1 line and it’s truncated if too long. If the body is very long, the notification will be scrollable. Character limitations for the title is ~960 characters and for the body is ~174 characters.	The image is shown at the bottom. Title is 1 line and it’s truncated if too long. If the body is very long then the notification will be scrollable. The title can be very long, up to ~1000 characters, the body can be ~256 characters long.

Note

Exceeding text in the expanded message is always cropped, not appearing.
The exact limits on character length depend on the device as well.

Web

On Web, the notification content limitations depend on the platform, browser, and device. Because of this, exact limits vary and the following values serve as general guidance:

Section	Limitation
Title	Generally, the length limit lies between 40 and 75 characters.
Body	The allowed length depends on the presence of an image in the notification. The body can be longer if no images are added. The values vary from 50 to 440 characters.
Actions	Notifications can have 3 actions in total.
Payload	The maximum payload allowed is 4kB per notification, including the image.

Known Limitation

On Chrome for macOS, notification click events may not fire reliably when only a single notification is present in the notification center. This is a known Chrome/macOS integration issue. The functionality works correctly when multiple notifications are present or on other browsers like Firefox.

Limitations for Images

• Keep images between 800 and 1,038 px wide.

• Always use landscape orientation. Images in rich push notifications are cropped to a ratio of approximately 16:9. The exact ratio varies by device.

warning

The image URL must use HTTPS.