From a48da20c0d89d1db4db2c31852b98c0ec8fade8b Mon Sep 17 00:00:00 2001
From: Ren yiwei <85666259+SSDWGG@users.noreply.github.com>
Date: Sat, 13 Jun 2026 17:00:18 +0800
Subject: [PATCH] docs: clarify local file relative paths

---
 .../supported-cryptography/local-storage.md                     | 2 +-
 .../supported-secret-stores/file-secret-store.md                | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/daprdocs/content/en/reference/components-reference/supported-cryptography/local-storage.md b/daprdocs/content/en/reference/components-reference/supported-cryptography/local-storage.md
index c8955c0669a..072b8cd4363 100644
--- a/daprdocs/content/en/reference/components-reference/supported-cryptography/local-storage.md
+++ b/daprdocs/content/en/reference/components-reference/supported-cryptography/local-storage.md
@@ -46,7 +46,7 @@ The above example uses secrets as plain strings. It is recommended to use a secr
 
 | Field              | Required | Details | Example |
 |--------------------|:--------:|---------|---------|
-| `path`             | Y        | Folder containing the keys to be loaded. When loading a key, the name of the key will be used as name of the file in this folder.  | `/path/to/folder` |
+| `path`             | Y        | Folder containing the keys to be loaded. Relative paths are resolved from the directory where the application is run; in Multi-App Run, this is the app's `appDirPath`. When loading a key, the key name is used as the file name in this folder. | `/path/to/folder` |
 
 **Example**
 
diff --git a/daprdocs/content/en/reference/components-reference/supported-secret-stores/file-secret-store.md b/daprdocs/content/en/reference/components-reference/supported-secret-stores/file-secret-store.md
index 85fddb04bea..02df97bd546 100644
--- a/daprdocs/content/en/reference/components-reference/supported-secret-stores/file-secret-store.md
+++ b/daprdocs/content/en/reference/components-reference/supported-secret-stores/file-secret-store.md
@@ -38,7 +38,7 @@ spec:
 
 | Field              | Required | Details                                                                 | Example                  |
 |--------------------|:--------:|-------------------------------------------------------------------------|--------------------------|
-| secretsFile        | Y        | The path to the file where secrets are stored   | `"path/to/file.json"` |
+| secretsFile        | Y        | The path to the file where secrets are stored. Relative paths are resolved from the directory where the application is run; in Multi-App Run, this is the app's `appDirPath`. | `"path/to/file.json"` |
 | nestedSeparator    | N        | Used by the store when flattening the JSON hierarchy to a map. Defaults to `":"` | `":"` 
 | multiValued        | N        | `"true"` sets the `multipleKeyValuesPerSecret` behavior. Allows one level of multi-valued key/value pairs before flattening JSON hierarchy. Defaults to `"false"` | `"true"` |