diff --git a/contents/docs/error-tracking/upload-source-maps/ios.mdx b/contents/docs/error-tracking/upload-source-maps/ios.mdx
index 9df612836dc4..803b575ad417 100644
--- a/contents/docs/error-tracking/upload-source-maps/ios.mdx
+++ b/contents/docs/error-tracking/upload-source-maps/ios.mdx
@@ -85,6 +85,14 @@ ${PODS_ROOT}/PostHog/build-tools/upload-symbols.sh
 
 </MultiLanguage>
 
+6. In the **Input Files** section of the Run Script phase, add:
+
+```
+$(DWARF_DSYM_FOLDER_PATH)/$(DWARF_DSYM_FILE_NAME)
+```
+
+This ensures the upload script runs after dSYM generation is complete.
+
 </Step>
 
 <Step title="Optional: Include source code context" badge="optional">
@@ -192,4 +200,8 @@ Ensure `ENABLE_USER_SCRIPT_SANDBOXING` is set to `NO` in your build settings.
 
 ### dSYMs not being generated
 
-Verify that `DEBUG_INFORMATION_FORMAT` is set to **DWARF with dSYM File** for the configuration you're building (Debug or Release).
\ No newline at end of file
+Verify that `DEBUG_INFORMATION_FORMAT` is set to **DWARF with dSYM File** for the configuration you're building (Debug or Release).
+
+### Script fails with "content_hash_mismatch"
+
+This happens when the upload script runs before Xcode finishes generating the dSYM files. Add `$(DWARF_DSYM_FOLDER_PATH)/$(DWARF_DSYM_FILE_NAME)` to the **Input Files** of the Run Script build phase — this tells Xcode to complete dSYM generation before running the upload script.
\ No newline at end of file