Skip to content

[Auto] [Improve] Documented missing File system path expressions and clarified async delete action #993

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
github-actions wants to merge 1 commit into
base: main
Choose a base branch
from
Open

[Auto] [Improve] Documented missing File system path expressions and clarified async delete action #993

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions automated_updates_data.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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-29",
"summary": "Improved File system docs: documented missing expressions (User's Home folder, Game executable file, and DirectoryName/FileName/ExtensionName path-parsing) and clarified the async Delete a file action"
}
]
}
15 changes: 14 additions & 1 deletion docs/gdevelop5/all-features/filesystem/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -184,7 +184,7 @@ It is advised to use the expressions for special folders (see below) to keep you

---

#### Delete a file
#### Delete a file (async)
This action deletes the file at the given file path __asynchronously__.
== Parameters ==
** File path: ** The path on the file system where the file is located.
Expand All @@ -204,6 +204,10 @@ This expression returns the operating system independent path to the _Documents_
This is the standard folder for storing documents.
#### This games executable folder
This expression returns the operating system independent path to the folder where your game is being executed from.
#### Game executable file
This expression returns the path to the game executable file itself (not just its folder).
#### User's Home folder
This expression returns the operating system independent path to the current user's _home_ folder (for example `C:\Users\Name` on Windows).
#### Pictures folder
This expression returns the operating system independent path to the _Pictures_ folder of the user that runs your game.
This is the standard folder for storing images.
Expand All @@ -217,6 +221,15 @@ This folder is used for storing application settings.
This expression returns the operating system independent path delimiter character. ("\" on Windows and "/" on Linux and macOS).
Use this expression to build cross-platform file paths that can be accessed on all supported operating systems.

These expressions extract parts of a file path (they take a path as their parameter and return a piece of it):

#### Get directory name from a path
This expression returns the directories portion of a path, without the ending file name.
#### Get file name from a path
This expression returns the name of the file with its extension, if any.
#### Get the extension from a file path
This expression returns the extension of the file designated by the given path, including the leading period (for example `.txt`).

## Example
In order to save a screenshot to the _Pictures_ directory you could write:

Expand Down