Skip to main content

Android channels

On Android 8+ every notification is posted to a channel, and the channel — not the push — decides importance, sound and vibration. Without this page the SDK uses one channel (default, high importance) for everything, so users cannot mute promotions while keeping order updates.

Android channels in settings

In Settings › Android channels define up to 20:

FieldMeaning
idStable identifier (promos, orders); letters, digits, _ . -. This is what a campaign selects.
Name / DescriptionShown in the system's notification settings for the app.
ImportanceHigh (heads-up banner + sound), Default (sound, no banner), Low (silent, in the shade).
Sounddefault, none, or a raw resource name bundled in the app (chime).
VibrationOn or off.

The list is replaced on save. A campaign chooses a channel in the content step's Presentation card (Android channel); the worker sends the id and the channel's definition with the push, and the SDK creates the channel on the device the first time it sees it. No app release is needed to introduce a channel.

Importance is set once

Android never lets an app change an existing channel's importance, sound or vibration — only the user can, in system settings. Changing those fields here affects devices that have not created the channel yet. For everyone else, use a new channel id.

A push that names a channel the device does not have and does not describe (an id deleted here, an older SDK) falls back to the SDK's default channel rather than being dropped.