diff --git a/docs/migrate-v2-to-v3.md b/docs/migrate-v2-to-v3.md
index ad2c566d17..1d70b5fdff 100644
--- a/docs/migrate-v2-to-v3.md
+++ b/docs/migrate-v2-to-v3.md
@@ -379,6 +379,25 @@ Similar messages would be shown for other funcs.
     }
     ```
 
+## PathFlag
+
+=== "v2"
+
+    ```go
+    &cli.PathFlag{
+        Name:   "foo",
+    }
+    ```
+
+=== "v3"
+
+    ```go
+    &cli.StringFlag{
+        Name:  "foo",
+        TakesFiles: true,
+    }
+    ```
+
 ## Authors
 
 === "v2"