Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

FCM: `apns.fcmOptions.imageUrl` and `notification.imageUrl` not rendering images for < iOS 18 and < ipadOS 18

Open
#2,807 3 comments 0 reactions 1 assignee View on GitHub

@chong-shao is already working on this.

Since Dec 19, 2024.

Assessment

This issue has not been assessed yet.

Description

api: messaging
[REQUIRED] Step 2: Describe your environment
  • Operating System version: < iOS 18, < ipadOS 18 (client), Ubuntu 14.04.6 LTS (server)
  • Firebase SDK version: 12.0.0
  • Firebase Product: Cloud messaging (FCM)
  • Node.js version: 16 (LTS)
  • Yarn version: 1.22.22
[REQUIRED] Step 3: Describe the problem

  1. Images do not render on iOS < 18 and ipadOS < 18 devices, when sending a payload with apns.fcmOptions.imageUrl or notification.imageUrl. I thought it might be related to image size so I sent an image with a size of 400 bytes but still no luck.

  2. Slightly unrelated, but the docs state to use apns.fcmOptions.image (source) whilst the TypeScript interface declares apns.fcmOptions.imageUrl (code). I've tried setting an ignore rule for the compiler to use apns.fcmOptions.image in the payload, whilst this also renders images for iOS 18 and ipadOS 18, it still doesn't render for iOS 17 and ipadOS 17 devices.

Steps to reproduce:

What happened? How can we make the problem occur?
This could be a description, log/console output, etc.

  1. Create notification payload with image url set as apns.fcmOptions.imageUrl or notification.imageUrl
  2. Send notification (using sendEachForMulticast())
  3. Observe received notification on iOS 18 and ipadOS 18 devices, image successfully displayed on both
  4. Observe received notification on iOS 17 and ipadOS 17 devices, image not displayed on either

Example: Successful notification on ios 18 with image

Screenshot 2024-12-12 at 11 31 42
Relevant Code:

Example payload

{
  apns: {
    fcmOptions: {
      imageUrl: "imageUrl"
    },
    payload: {
      aps: {
        alert: {
          body: "body"
        },
        mutableContent: true
      }
    }
  }
}
Dominant language
TypeScript
Stars
1.7k
Forks
419
Avg merge
4d 20h
Merged PRs (30d)
16

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from firebase/firebase-admin-node

All issues in firebase/firebase-admin-node

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.