Fixing push notifications on Android 8. Aka channels

Upgrading your target SDK to 26+ (Android 8) can break your push notifications all of a sudden. Fortunatelly it´s very easy to fix.

Android 8 (API level 26) expects any notification to use a Channel. So we need to implement them but only when the API level is 26+. Channels should be ignored otherwise because they won´t be available, meaning that your app will throw an exception if you try to use them.

We will create a default channel to be used when any push notification arrives. You can actually create multiple channels but I bet most applications will be just fine with one.

public static class NotificationHelper
    public const string ChannelId = "com.unique.string.onyourapp.default";

    // make sure you call this method only once
    public static void CreateDefaultChannel(Context context)
        if (Build.VERSION.SdkInt < BuildVersionCodes.O) 
        var channel = new NotificationChannel(ChannelId, "AppName default",
        channel.LockscreenVisibility = NotificationVisibility.Public;

        var notificationManager = (NotificationManager) context

    // method extension to ease the creation of the nofication
    public static NotificationCompat.Builder SetChannelIdIfNeeded(
        this NotificationCompat.Builder builder,
        string channelId)
        if(Build.VERSION.SdkInt >= BuildVersionCodes.O)
        return builder;

I´ts a good idea to create the default channel at app start, either on your main activity or your custom Application OnCreate() override:

public override void OnCreate()

And last, but not least, you need to make and slight modification to the code that creates the notification.


var notificationBuilder = new NotificationCompat.Builder(this)
    .SetSmallIcon (Resource.Drawable.ic_notification)


var notificationBuilder = new NotificationCompat.Builder(this)
    .SetChannelIdIfNeeded(NotificationHelper.ChannelId) // method extension
    .SetSmallIcon (Resource.Drawable.ic_notification)

From now on your push notifications will start working again on Android 8.

Related Posts

How to use Charles Proxy in Xamarin to capture network traffic (including SSL)

Android 8 adaptative (vector) icons

UIStackView magic

When Apple realized a LinearLayout could be useful for developers...

Getting fancy with UIView anchors and state changes

A simple page-indicator for your android view-pager

A bit of xml and C#. No 3rd party libs required

Large file downloads on Windows 10 mobile

Download safely in the background with progress feedback

UWP mobile side loading

SQLite.NET > async VS sync

Or how we (developers) love to complicate our code base

Making iOS forms usable

Prevent user frustration by implementing good practices with Xamarin.iOS

Easy and cross-platform localization (Xamarin & .NET)

Share locales from a PCL. Get up and running in no time