FirebaseHow-ToBeginner · 4 min read

How to Send Notification to Topic in Firebase

To send a notification to a topic in Firebase, use Firebase Cloud Messaging's sendToTopic() method with the topic name and message payload. This lets you broadcast messages to all devices subscribed to that topic easily.

📐

Syntax

The basic syntax to send a notification to a topic in Firebase Cloud Messaging (FCM) is:

admin.messaging().sendToTopic(topic, payload, options)
topic: The name of the topic to send the message to, starting with a string like 'news' or 'weather'.
payload: The message content including notification title and body.
options: Optional settings like message priority.

javascript

admin.messaging().sendToTopic('topicName', {
  notification: {
    title: 'Title here',
    body: 'Body text here'
  }
}, {
  priority: 'high'
});

💻

Example

This example shows how to send a notification to the topic news using Firebase Admin SDK in Node.js. It sends a notification with a title and body to all devices subscribed to the news topic.

javascript

const admin = require('firebase-admin');

// Initialize Firebase Admin SDK with your service account
admin.initializeApp({
  credential: admin.credential.applicationDefault()
});

const topic = 'news';

const message = {
  notification: {
    title: 'Breaking News',
    body: 'New updates are available now!'
  }
};

admin.messaging().sendToTopic(topic, message, {priority: 'high'})
  .then((response) => {
    console.log('Successfully sent message:', response);
  })
  .catch((error) => {
    console.log('Error sending message:', error);
  });

Output

Successfully sent message: { messageId: 'projects/project-id/messages/message-id' }

⚠️

Common Pitfalls

Common mistakes when sending notifications to topics include:

Using topic names with invalid characters or spaces. Topic names must be alphanumeric and can include underscores.
Not initializing Firebase Admin SDK properly before sending messages.
Forgetting to subscribe client devices to the topic before sending messages.
Not handling promise rejections which can hide errors.

javascript

/* Wrong: topic name with spaces */
admin.messaging().sendToTopic('news updates', { notification: { title: 'Hi', body: 'Hello' } });

/* Right: topic name without spaces */
admin.messaging().sendToTopic('news_updates', { notification: { title: 'Hi', body: 'Hello' } });

📊

Quick Reference

Tips for sending notifications to topics in Firebase:

Topic names must be valid strings without spaces.
Use Firebase Admin SDK on a trusted server environment.
Subscribe client apps to topics using Firebase client SDK.
Use sendToTopic() to broadcast messages.
Handle success and error responses to confirm delivery.

✅

Key Takeaways

Use Firebase Admin SDK's sendToTopic() method to send notifications to all devices subscribed to a topic.

Ensure topic names are valid and client devices are subscribed before sending messages.

Initialize Firebase Admin SDK properly with credentials before sending notifications.

Handle promise results to catch errors and confirm message delivery.

Use high priority option for urgent notifications to reach devices faster.