FlutterFlow Docs
Basic Troubleshooting Guide
This is a general troubleshooting guide for any issues that occur with FlutterFlow projects.

Backend Issues

The following steps will help you fix the issues like Grey Screen error, Infinite Loading screen, Firestore record creating error, etc. These common steps are recommended to perform for any issue faced with the backend.
  • Ensure you have added the following cloud permissions for [email protected]: Editor, Cloud Functions Admin, and Service Account User. Here are instructions on how to do this.
  • Update your Firebase rules. Here are instructions on how to do this.
  • Make sure all the data fields types and field names should match in Firestore and FlutterFlow. Here are instructions on how to do this.
  • If you have already completed the Firebase setup, remove the existing permissions and complete a new setup from scratch. Here are instructions on how to do this.
  • Make sure you've added app.flutterflow.io to Authorized Domains under the authentication tab in Firebase.
  • Ensure you are on the latest version of FlutterFlow by selecting (ctrl/cmd + R). After you have done this, clear your browser cache and log out/in to FlutterFlow.
  • In order to use Cloud Functions like Push Notifications, Payments, etc. Please make sure your Firebase project is on a Blaze Plan.

Frontend (UI builder) issues

The following steps will help you fix the issues with the UI builder inside FlutterFlow.
  • In case of overflowing text, it's recommended that you wrap the Text Widget inside an Expanded widget. To do this just click on the Expand option in the alignment properties of the Text Widget.
  • If you notice scaling issues with widgets then please make sure that you set percentage values for dimensions of the widgets.
  • When renaming a custom widget or custom action, please make sure that you rename the widget from the code as well.
  • Please make sure not to upload duplicate media assets in the Project Media Assets.
  • Make sure you've entered the correct API keys when using third-party integrations.
  • Clear your browser cache and history if FlutterFlow seems to be laggy.
  • Change browser or use incognito/private browsing mode if you're not able to start from the login screen when using the Test/Run mode.
Copy link
On this page
Backend Issues
Frontend (UI builder) issues