Skip to main content
All CollectionsHelp & Troubleshooting GuidesBasic Troubleshooting Guides
Troubleshooting Push Notification Issues in FlutterFlow
Troubleshooting Push Notification Issues in FlutterFlow
Barry avatar
Written by Barry
Updated over 7 months ago

Push notifications play a vital role in mobile apps, enabling you to connect with your audience and update them on key developments. Yet, there are instances when push notifications fail to deliver. In this guide, we will explore the typical problems that hinder push notifications in FlutterFlow and offer detailed instructions on how to fix them.


Without CodeMagic Deployment In FlutterFlow

If you are using CodeMagic deployment, please see the section With CodeMagic Deployment.


Ensure your subscription status hasn't changed.

Head to the Firebase Console and select Project Settings > Usage & Billing > Details & Settings.

If you see Spark listed, you will need to select Modify Plan and upgrade to a Blaze Plan.

Click here for more information on Firebase pricing plans.

1. Ensure you have added the required cloud permissions


For push notifications to work, you will need to add the following cloud permissions for firebase@flutterflow.io: Editor, Cloud Functions Admin, and Service Account.

Head to the Firebase Console and open the project dashboard for your project (click the project tile). Select Project Settings > Users & Permissions.

If you don't have Cloud Functions Admin, Editor, and Service Account listed next to fireabse@flutterflow.io, you have not completed this step.

Here are the instructions on how to add the required cloud permissions to your project.


If you encounter an error in FlutterFlow related to insufficient permissions for the firebase@flutterflow.io account, follow these steps to resolve the issue:

Step 1: Open Firebase Console

Click on the project tile to open the project dashboard for your FlutterFlow project.

Step 2: Navigate to Users & Permissions

In the project dashboard, click on the gear icon (⚙️) in the top-left corner to open the project settings.

From the left sidebar, select "Users & Permissions" under the "Project" section.

Step 3: Locate the firebase@flutterflow.io Account

In the "Users" tab, look for the firebase@flutterflow.io account in the list of users.

If the account is not present, you may need to add it by clicking on the "Add User" button and entering firebase@flutterflow.io as the email address.

Step 4: Assign Necessary Permissions

Click on the firebase@flutterflow.io account to open the user details page.

In the "Permissions" section, ensure that the following permissions are assigned to the account:

  • Editor

  • Cloud Functions Admin

  • Service Account User

If any of these permissions are missing, click on the "Add Permissions" button and select the required permissions from the dropdown menu.

Step 5: Save the Changes

After adding the necessary permissions, click on the "Save" button to apply the changes.

Double-check that all the permissions have been successfully added and saved.

Step 6: Retry the Operation in FlutterFlow

Go back to your FlutterFlow project and retry the operation that previously caused the permission error.

The error should now be resolved, and FlutterFlow should be able to access the required Firebase resources.

If you continue to face issues after following these steps, please reach out to the FlutterFlow support team for further assistance.

Note: Ensuring that the firebase@flutterflow.io account has the necessary permissions is crucial for FlutterFlow to interact with your Firebase project correctly

Ensure that all these permissions have been added and saved.

2. Ensure you have created a push notification key for Apple


Apple requires developers to create a key for the push notifications inside the Apple Developer Console to verify the push notification's sender.

Head to your Apple Developer account and select Certificates, Identifiers & Profiles > Keys.

If you haven't added a push notification key, you will need to add this.

Here are instructions on how to add a push notification key.

3. Ensure you have added the APN key to Firebase


Head to the Firebase Console and open the project dashboard for your project (click the project tile). Select Project Settings > Project Settings > Cloud Messaging.

Scroll down to the iOS section. If you have no files listed under APNs Authentication Key (like the photo below), you need to upload the APN Key.

Here are the instructions on how to upload the APN key to Firebase.

4. Ensure you have added a push notification identifier for Apple


You must add an Identifier to be able to send the push notifications to the iOS devices after you deploy your app to the app store.

Head to your Apple Developer account and select Certificates, Identifiers & Profiles.

If you haven't created a push notification identifier, you will need to add this.

Here are instructions on how to create your push notification identifier.

With CodeMagic Deployment

If you are not using CodeMagic deployment, please see the section Without CodeMagic Deployment.


Error 1: Signing for "ImageNotification" requires a development team - Flutterflow and Local builds

Error (Xcode): Signing for "ImageNotification" requires a development team. Select a development team in the Signing & Capabilities editor.

Method 1 - FlutterFlow Deployment

These are the steps to follow if you are building from FlutterFlow instead of GitHub in this case.

Having reviewed the guidelines on how to add an identifier in the Apple Developer console.

In the Apple Developer console, under the Identifiers section:


Please verify that an identifier is created with the name 'ImageNotification' and the Identifier set to be the package name of your app + plus the extension .ImageNotification appended to it.

Verification Of Identifier And Capabilities

Register an Identifier of type App IDs

Select the type 'App' then click 'Continue'

Set the description to 'ImageNotifcation' and the bundle ID to the package name of your application + the extension '.ImageNotification' appended at the end.

Enable the Push Notification capability and continue from there.


The Identifier should be created from there and it will take up the form shown in the image below.

You should be set to deploy to your application once more!


Method 2: GitHub Deployment


These are the steps to follow if you are deployment from GitHub in your FlutterFlow.

To fix this error you need to add an Apple Developer Team Profile to your Xcode project.

1. First, you'll need to open the iOS folder inside the project file in Xcode.

2. After that, you will need to click on the runner folder of the project and select the sign-in and Capabilities option

3. You should be able to see the tab shown in the screenshot. Click on add account, Once you add the profile, you should see the list of teams appear at the top of the signing and capabilities panel. You can select the one that matches the team you would like to use, save the settings, and then try to build the project again.

Additional Resources


Did this answer your question?