Android Notification Channels for FCM — Complete Setup Guide

Android 8.0 (Oreo) introduced Notification Channels, requiring apps to categorize notifications. Here's how to set them up with FCM.

What Are Notification Channels?

Notification channels let users control notification behavior per category. Each channel can have its own:

• Sound
• Vibration pattern
• LED color
• Importance level
• Lock screen visibility

Creating Channels in Android

Create channels when your app starts:

kotlinCopy
val channel = NotificationChannel(
    "messages",
    "Messages",
    NotificationManager.IMPORTANCE_HIGH
).apply {
    description = "Chat message notifications"
    enableLights(true)
    lightColor = Color.BLUE
    enableVibration(true)
}

val manager = getSystemService(NotificationManager::class.java)
manager.createNotificationChannel(channel)

Common Channel Setup

Most apps need these channels:

Sending to a Channel via FCM

Specify the channel in your FCM payload's Android config:

jsonCopy
{
  "message": {
    "token": "device_token",
    "notification": {
      "title": "New Message",
      "body": "Hey, are you free tonight?"
    },
    "android": {
      "notification": {
        "channel_id": "messages",
        "sound": "notification_sound",
        "notification_priority": "PRIORITY_HIGH"
      }
    }
  }
}

Handling Channel IDs in Flutter

In your Flutter app using firebase_messaging and flutter_local_notifications:

dartCopy
const androidChannel = AndroidNotificationChannel(
  'messages',
  'Messages',
  description: 'Chat message notifications',
  importance: Importance.high,
  sound: RawResourceAndroidNotificationSound('notification_sound'),
);

await FlutterLocalNotificationsPlugin()
    .resolvePlatformSpecificImplementation<
        AndroidFlutterLocalNotificationsPlugin>()
    ?.createNotificationChannel(androidChannel);

Best Practices

1. Create channels early — Do it on app startup, before any notification arrives
2. Use descriptive names — Users see these in Settings
3. Don't overuse HIGH importance — Reserve it for truly urgent notifications
4. Test on Android 8.0+ — Channels are required; without one, notifications may not show
5. Provide a fallback — Always set a default channel for unexpected notifications

Testing Your Channels

Use our Payload Validator to verify your android.notification.channel_id is correctly set before sending.