diff --git a/hadoop-hdfs-project/hadoop-hdfs/CHANGES.txt b/hadoop-hdfs-project/hadoop-hdfs/CHANGES.txt
index 69019ef1ea2..0594162963d 100644
--- a/hadoop-hdfs-project/hadoop-hdfs/CHANGES.txt
+++ b/hadoop-hdfs-project/hadoop-hdfs/CHANGES.txt
@@ -359,6 +359,9 @@ Release 2.5.0 - UNRELEASED
 
     HDFS-4909. Avoid protocol buffer RPC namespace clashes. (cmccabe)
 
+    HDFS-6153. Document "fileId" and "childrenNum" fields in the FileStatus Json schema
+    (Akira Ajisaka via vinayakumarb)
+
 Release 2.4.1 - UNRELEASED
 
   INCOMPATIBLE CHANGES
diff --git a/hadoop-hdfs-project/hadoop-hdfs/src/site/apt/WebHDFS.apt.vm b/hadoop-hdfs-project/hadoop-hdfs/src/site/apt/WebHDFS.apt.vm
index fbfd880c1f4..46f59cbdf62 100644
--- a/hadoop-hdfs-project/hadoop-hdfs/src/site/apt/WebHDFS.apt.vm
+++ b/hadoop-hdfs-project/hadoop-hdfs/src/site/apt/WebHDFS.apt.vm
@@ -482,6 +482,8 @@ Transfer-Encoding: chunked
   {
     "accessTime"      : 0,
     "blockSize"       : 0,
+    "childrenNum"     : 1,
+    "fileId"          : 16386,
     "group"           : "supergroup",
     "length"          : 0,             //in bytes, zero for directories
     "modificationTime": 1320173277227,
@@ -523,6 +525,8 @@ Content-Length: 427
       {
         "accessTime"      : 1320171722771,
         "blockSize"       : 33554432,
+        "childrenNum"     : 0,
+        "fileId"          : 16387,
         "group"           : "supergroup",
         "length"          : 24930,
         "modificationTime": 1320171722771,
@@ -535,6 +539,8 @@ Content-Length: 427
       {
         "accessTime"      : 0,
         "blockSize"       : 0,
+        "childrenNum"     : 2,
+        "fileId"          : 16388,
         "group"           : "supergroup",
         "length"          : 0,
         "modificationTime": 1320895981256,
@@ -1331,6 +1337,18 @@ var fileStatusProperties =
       "type"       : "integer",
       "required"   : true
     },
+    "childrenNum":
+    {
+      "description": "The number of children.",
+      "type"       : "integer",
+      "required"   : true
+    },
+    "fileId":
+    {
+      "description": "The inode ID.",
+      "type"       : "integer",
+      "required"   : true
+    },
     "group":
     {
       "description": "The group owner.",