From 27bc6c8fca4515f3fbb208e227f5667a59105d6a Mon Sep 17 00:00:00 2001
From: DogmaDragon <103123951+DogmaDragon@users.noreply.github.com>
Date: Thu, 26 Jun 2025 00:33:55 +0300
Subject: [PATCH] Update captions documentation (#5967)

* Update captions documentation to clarify file location and naming conventions
* Clarify naming convention
---
 ui/v2.5/src/docs/en/Manual/Captions.md | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/ui/v2.5/src/docs/en/Manual/Captions.md b/ui/v2.5/src/docs/en/Manual/Captions.md
index e52fc54bb..df2bee8bc 100644
--- a/ui/v2.5/src/docs/en/Manual/Captions.md
+++ b/ui/v2.5/src/docs/en/Manual/Captions.md
@@ -2,15 +2,17 @@
 
 Stash supports captioning with SRT and VTT files.
 
-These files need to be named as follows:
+Captions will only be detected if they are located in the same folder as the corresponding scene file.
+
+Ensure the caption files follow these naming conventions:
 
 ## Scene
 
-- {scene_name}.{language_code}.ext
-- {scene_name}.ext
+- {scene_file_name}.{language_code}.ext
+- {scene_file_name}.ext
 
 Where `{language_code}` is defined by the [ISO-6399-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) (2 letters) standard and `ext` is the file extension. Captions files without a language code will be labeled as Unknown in the video player but will work fine.
 
 Scenes with captions can be filtered with the `captions` criterion.
 
-**Note:** If the caption file was added after the scene was initially added during scan you will need to run a Selective Scan task for it to show up. 
+**Note:** If the caption file was added after the scene was initially added during scan, you will need to run a Selective Scan task for it to show up.