From a3f91f5da9e711812bcf612ec1c4b2b902560f69 Mon Sep 17 00:00:00 2001
From: 4ian <1280130+4ian@users.noreply.github.com>
Date: Fri, 26 Jun 2026 09:19:31 +0000
Subject: [PATCH] [Auto] [Update] Document configurable custom resource
 properties in gdevelop-settings.yaml for teams

---
 automated_updates_data.json                   |  2 +-
 .../how-to-use-gdevelop-as-a-team/index.md    | 19 +++++++++++++++++++
 2 files changed, 20 insertions(+), 1 deletion(-)

diff --git a/automated_updates_data.json b/automated_updates_data.json
index f4814526d15..36e2f3e428c 100644
--- a/automated_updates_data.json
+++ b/automated_updates_data.json
@@ -1,5 +1,5 @@
 {
-  "last_automated_updates_commit": "2aa0fdea7bb1367dae9b31588ad3702f8f1b5be5",
+  "last_automated_updates_commit": "5364af2eb003ad02c42ddcf4e994c050e4fce689",
   "last_improved_things": [
     {
       "date": "2026-02-16",
diff --git a/docs/gdevelop5/tutorials/how-to-use-gdevelop-as-a-team/index.md b/docs/gdevelop5/tutorials/how-to-use-gdevelop-as-a-team/index.md
index 46340268ddb..fd0cd1535d0 100644
--- a/docs/gdevelop5/tutorials/how-to-use-gdevelop-as-a-team/index.md
+++ b/docs/gdevelop5/tutorials/how-to-use-gdevelop-as-a-team/index.md
@@ -97,6 +97,25 @@ toolbarButtons:
 
 A button with a `hook` still appears in the toolbar and can be clicked manually as well. GDevelop will show a one-time security confirmation before running any npm script, since scripts execute on your computer.
 
+### Custom resource properties
+
+You can declare extra, editable fields for your project's resources (images, audio, fonts...) by adding a `resourceCustomProperties` section to `gdevelop-settings.yaml`. These fields appear in the Resource Properties editor and are saved alongside the resource. This is useful for teams who need to attach their own metadata to assets, for example to drive a custom asset pipeline.
+
+```yaml
+resourceCustomProperties:
+  - name: keepHighResolution
+    label: Keep high resolution
+    type: boolean
+    description: Do not downscale this image when exporting
+    resourceKinds: ["image"]
+  - name: compressionQuality
+    label: Compression quality
+    type: number
+    resourceKinds: ["image"]
+```
+
+Each entry requires a `name` (the key used to store the value) and a `type`, which can be `string`, `boolean` or `number`. You can also add a `label` (shown in the editor), a `description`, a `default` value, and `resourceKinds` to limit the field to specific resource types (such as `image` or `audio`).
+
 !!! note
 
     Project-specific settings and custom toolbar buttons are only supported in the desktop version of GDevelop.