Guide

Testing Push Notifications on iOS

iOS-specific guide for APNs configuration, entitlements, and verifying FCM delivery on iPhone and iPad.

Last updated: May 2026

iPhone displaying mobile apps — configure APNs before FCM iOS testing
Configure APNs in Firebase Console before testing on iPhone or iPad

APNs setup in Firebase

Upload an APNs Authentication Key (.p8) or production/development certificate in Firebase Console → Project settings → Cloud Messaging → Apple app configuration. The key works for both sandbox and production.

iPhone on a desk for testing push notifications from Firebase Cloud Messaging
Simulators cannot receive remote push — use a physical iOS device

Xcode capabilities

  • Push Notifications capability enabled
  • Background Modes → Remote notifications
  • Correct Bundle ID registered in Firebase
  • Physical device required for reliable push testing

Sandbox vs production

Development builds use APNs sandbox; App Store builds use production. FCM abstracts much of this, but mismatched certificates can cause silent failures. Check Xcode device logs when notifications do not arrive.

Continue with our complete testing guide or open the FCM tester to send a notification now.

Ready to test? Open the FCM tester · Browse all guides

Guide photos from Unsplash & Pexels (free license)