improved formatting, updated content

Author: mrdavidorok

docs/troubleshooting/backend-issues/backend_call_update_document_action_is_not_working.md

@@ -1,30 +1,30 @@
 ---
 keywords: ['listview', 'returning', 'only']
 slug: /my-listview-is-only-returning-one-item
-title: My listview is only returning one item
+title: My ListView Is Only Returning One Item
 ---
-# My listview is only returning one item
+# My ListView Is Only Returning One Item
 
+If your **ListView** is only returning one item in FlutterFlow, check the following possible causes:
 
-## Things to check if you listview is only returning one item
+- **Use a Dynamic Widget**
 
-Here are the things to check if you are facing this issue:
+    Ensure you are using a dynamic widget such as **ListView**, **GridView**, **Row**, or **Column** to dynamically generate multiple children.
 
-## - Use a dynamic widget
+- **Query for a List**
 
-    Make sure you are using a **ListView**, **GridView**, **Row**, or **Column** to dynamically generate the children.
+    Confirm that your query retrieves a **list of documents** rather than a single record.
 
-## - Query for a list
-    Ensure your query is for a **list of documents** and not a single record.
+- **Check Filters**
 
-## - Check filters
-    If you are using a filter, make sure the data present in Firestore has **more than one record** that can pass through the filter.
+    If you're applying filters, make sure that your Firestore database contains **multiple records** that satisfy the filter conditions.
 
-## - Sufficient records
-    Make sure that your Firestore collection has **enough records**.
+- **Sufficient Records**
 
-## - ListType field 
+    Verify that your Firestore collection has **enough records** to display multiple items.
 
-    If you are querying a single field, make sure it’s a **ListType field** in both FlutterFlow and Firebase.
+- **List Type Field**
 
+    If you are querying a single field, ensure that it’s defined as a **ListType field** in both FlutterFlow and Firebase.
 
+By carefully reviewing these areas, you should be able to resolve the issue of your ListView returning only one item.

docs/troubleshooting/backend-issues/backend_issues.md

@@ -0,0 +1,62 @@
+---
+keywords: ['backend', 'issues', 'troubleshooting']
+slug: /troubleshooting-backend-issues-in-flutterflow
+title: Troubleshooting Backend Issues in FlutterFlow
+---
+# Troubleshooting Backend Issues in FlutterFlow
+
+If you are facing issues related to the backend in FlutterFlow, follow these steps to ensure your Firebase setup is correctly configured:
+
+- **Add Proper Cloud Permissions**
+
+    Grant the following permissions to **[email protected]** in your Firebase project:
+
+        - **Editor**
+        - **Cloud Functions Admin**
+        - **Service Account User**
+
+    **[Learn how to assign Firebase permissions.](/integrations/firebase/connect-to-firebase/#allow-flutterflow-to-access-your-project)**. 
+
+- **Update Firebase Rules**
+
+    Ensure that your Firebase Firestore security rules are updated correctly.
+
+    **[See how to update Firebase rules.](/integrations/database/cloud-firestore/firestore-rules/)**.
+
+    After updating the rules, delete **[email protected]** from your authenticated users, redeploy the Firestore rules, and validate the schema again.
+
+    ![](../assets/20250430121532523511.png)
+
+- **Match Data Field Types and Names**
+
+    Verify that all data field types and field names match between **Firestore** and **FlutterFlow**.
+
+- **Validate Firestore Schema**
+
+    Use the **Validate** button in **Firestore → Settings** inside FlutterFlow to confirm that the Firestore collection schema matches the FlutterFlow configuration.
+
+    ![](../assets/20250430121532793176.png)
+
+- **Reset Firebase Setup (If Needed)**
+
+    If you have already completed the Firebase setup but continue to experience issues, remove existing permissions and complete the setup process from scratch.
+
+    **[Follow Firebase setup instructions.](/integrations/firebase/connect-to-firebase/)**.
+
+- **Authorized Domains**
+
+    Add `app.flutterflow.io` to your **Authorized Domains** under the **Authentication** tab in Firebase.
+
+- **Refresh FlutterFlow**
+
+    Make sure you are using the latest version of FlutterFlow:
+
+    - Press **Ctrl/Cmd + Shift + R** to refresh.
+    - Clear your browser cache.
+    - Log out and back into FlutterFlow.
+
+- **Use Blaze Plan for Cloud Functions**
+
+    To use Cloud Functions like Push Notifications, Payments, and other features, ensure your Firebase project is on the **Blaze Plan**.
+
+By following these steps, most backend issues in FlutterFlow can be resolved effectively.

docs/troubleshooting/backend-issues/backend_query_is_failing_and_my_list_shows_a_gray_box_instead_of_a_list_of_items_I_get_a_red_screen_in_test_mode..md

@@ -0,0 +1,58 @@
+---
+keywords: ['call', 'document', 'backend']
+slug: /update-document-action-fails-during-backend-call
+title: Backend Call Update Document Action Not Working
+---
+# Backend Call Update Document Action Not Working
+
+When performing the **Update Document** action, you may encounter a situation where the loading indicator appears but then stops without completing the action. This indicates that the update was unsuccessful. If the update succeeds, the next steps in your action flow, such as displaying an alert dialog, should execute automatically.
+
+![](../assets/20250430121241690449.gif)
+
+![](../assets/20250430121241899370.png)
+
+:::note
+After performing the update action, always verify that the data has been correctly updated in your database. If your document is not streamed in real-time within your app, the updated data may not immediately appear. Check the data in FlutterFlow CMS or directly in Firebase to confirm the update.
+:::
+
+**Why Does Updating a Document Fail?**
+
+When the update action fails, the action flow stops, preventing any subsequent actions from executing.
+
+There are two common reasons why the update action may fail:
+
+1. **Permission Issue in Firestore**
+
+    The user may not have the necessary permission to write to the document.
+
+    ![](../assets/20250430121242149430.png)
+
+    **Cause:**  
+    The Firestore security rules may not allow the current user to write (edit) documents. 
+
+    **Solution:**  
+    Review and configure your Firestore rules to grant write permission. For example, allowing write access to authenticated users is often sufficient if your app requires user authentication.
+
+2. **Data Type Mismatch**
+
+    The values you are attempting to write may not match the expected field types.
+
+    For example, assigning a string value to a field that expects an integer will result in failure.
+
+    ![](../assets/20250430121242530889.png)
+
+    **Cause:**  
+    Attempting to write a value of the wrong type, such as assigning text to a number field.
+
+    **Solution:**  
+    Verify that the values being written match the expected data types for each field. If the data comes from an API call or form input, consider using custom actions to convert the value to the appropriate type before performing the update.
+
+    :::note 
+    If you want to save a text field value as a number, ensure that the text field input type is set to **Number**.
+    :::
+
+:::info[Additional Troubleshooting]
+You can check for error details in your browser's developer console (F12). For example, permission errors will typically appear in the console logs, as shown below:
+
+![](../assets/20250430121242814005.png)
+:::