From f462c86e0b493773cc9d1844912f53aeff607bb0 Mon Sep 17 00:00:00 2001
From: Yuri Salimovskiy <yuri@packettide.com>
Date: Sat, 20 Sep 2025 12:06:08 +0300
Subject: [PATCH] Clarify usage to achieve same behaviour as pre-defined
 manipulation

requires https://github.com/ExpressionEngine/ExpressionEngine/pull/4988
---
 docs/fieldtypes/file.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/fieldtypes/file.md b/docs/fieldtypes/file.md
index a244d3c3..cd904cfc 100755
--- a/docs/fieldtypes/file.md
+++ b/docs/fieldtypes/file.md
@@ -310,6 +310,8 @@ Resize the image and then crop it.
 | crop:x        | `Number` | `0`| Horizontal crop offset, px |
 | crop:y        | `Number` | `0`| Vertical crop offset, px |
 
+The output of this tag might differ from "Crop" pre-defined image manipulation as set in Upload Directory settings. To achieve exact same behaviour you need to set `width` and `height` parameters to the same values for both resize and crop.
+
 ### Using as modifier tags pairs
 
     {news_image:resize width="100" height="100"}