diff --git a/automated_updates_data.json b/automated_updates_data.json
index 88dd158d37e..2e805ef382e 100644
--- a/automated_updates_data.json
+++ b/automated_updates_data.json
@@ -104,6 +104,10 @@
     {
       "date": "2026-07-07",
       "summary": "Improved keyboard docs: added 'Key just pressed' (held vs one-frame) and 'Any key released' conditions, control-remapping note, and a reference list of valid key names"
+    },
+    {
+      "date": "2026-08-31",
+      "summary": "Improved screenshot docs: added desktop-only platform limitation warning and noted automatic .png suffix and background file writing"
     }
   ]
 }
diff --git a/docs/gdevelop5/all-features/screenshot/index.md b/docs/gdevelop5/all-features/screenshot/index.md
index bb4518a4228..c39e0d7446a 100644
--- a/docs/gdevelop5/all-features/screenshot/index.md
+++ b/docs/gdevelop5/all-features/screenshot/index.md
@@ -7,6 +7,10 @@ This extension lets you save a screenshot of the running game in a specified fol
 
 Note: As of GDevelop 5.0.0-beta92 the screenshot action is no longer an extension. Just add an action and search for `screenshot` or go to `Other Actions`/`Screenshot`/`Take screenshot`.
 
+!!! warning
+
+    Taking a screenshot only works when the game runs as a desktop app (Windows, Linux or macOS). It has no effect in the web browser preview, in web games or on mobile, because these platforms don't allow writing files to the computer.
+
 ### Actions
 
 #### Take screenshot
@@ -21,6 +25,8 @@ The save path needs to be an absolute path on the file system (Like "C:\MyFolder
 
 Relative paths are not supported.
 
+If the path doesn't already end with `.png`, the `.png` suffix is added automatically. The image is written in the background, so it may take a brief moment before the file appears on disk.
+
 !!! note
 
     In order to create a game that runs on all supported platforms you should use the special folders from the file system extension in combination with the path separator. These determine the path to common folders like *Pictures*, *Documents* or *Desktop* automatically. You can read more about it in [this article](/gdevelop5/all-features/filesystem).