From 1ef1b7be6513a96f6db206a15562e78a9efadaed Mon Sep 17 00:00:00 2001
From: Yuri Salimovskiy <yuri@packettide.com>
Date: Fri, 13 Oct 2023 12:09:48 +0300
Subject: [PATCH] Added `{folder_id}` variable and parameter for subfolder
 support in `exp:file:entries` tag

---
 docs/add-ons/file.md    | 10 ++++++++++
 docs/fieldtypes/file.md |  4 ++++
 2 files changed, 14 insertions(+)

diff --git a/docs/add-ons/file.md b/docs/add-ons/file.md
index be76318c4..916038805 100755
--- a/docs/add-ons/file.md
+++ b/docs/add-ons/file.md
@@ -122,6 +122,12 @@ The file display engine sets some parameters dynamically, based on what is in th
 
 You can hard code the file entries tag to show specific files. You may also specify multiple files by separating them with the pipe character. This parameter takes precedence over any entry specified in the url.
 
+### `folder_id=`
+
+    folder_id="34"
+
+If you want to display only the files that are in certain folder within Upload Directory, specify folder ID using this parameter.
+
 ### `limit=`
 
     limit="30"
@@ -219,6 +225,10 @@ If you have defined any [image manipulations](control-panel/file-manager/upload-
 
 The URL to the file.
 
+### `{folder_id}`
+
+If the file is in a subfolder, will return ID of the folder. If the file is in root or upload directory, will return 0.
+
 ### `{height}`
 
 The height (in pixels) of the full-size image. (Empty for non-image files.)
diff --git a/docs/fieldtypes/file.md b/docs/fieldtypes/file.md
index 3f7d62c48..aaf4f8301 100755
--- a/docs/fieldtypes/file.md
+++ b/docs/fieldtypes/file.md
@@ -126,6 +126,10 @@ If you have defined any [image manipulations](control-panel/file-manager/upload-
     {file_size:small:human}
     {file_size:small:human_long}
 
+### `{folder_id}`
+
+If the file is in a subfolder, will return ID of the folder. If the file is in root or upload directory, will return 0.
+
 ### `{height}`
 
 The height of the image (in pixels) if applicable.