diff --git a/hadoop-hdds/docs/content/interface/O3fs.md b/hadoop-hdds/docs/content/interface/O3fs.md
index f2cfb37381e6..c56efb521bf6 100644
--- a/hadoop-hdds/docs/content/interface/O3fs.md
+++ b/hadoop-hdds/docs/content/interface/O3fs.md
@@ -63,6 +63,14 @@ Please add the following entry to the core-site.xml.
 </property>
 ```
 
+<div class="alert alert-warning" role="alert">
+
+Tip: For the [OM HA]({{< ref "feature/OM-HA.md">}}) cluster, you need to specify the ozone service id. For example, 
+if `ozone.om.service.ids = ozone1`, then the URL is `o3fs://bucket.volume.ozone1`.
+For non-HA, it can be `o3fs://bucket.volume`.
+
+</div>
+
 This will make this bucket to be the default Hadoop compatible file system and register the o3fs file system type.
 
 You also need to add the ozone-filesystem-hadoop3.jar file to the classpath:
diff --git a/hadoop-hdds/docs/content/interface/O3fs.zh.md b/hadoop-hdds/docs/content/interface/O3fs.zh.md
index 38a807f45766..fa8b4d898aba 100644
--- a/hadoop-hdds/docs/content/interface/O3fs.zh.md
+++ b/hadoop-hdds/docs/content/interface/O3fs.zh.md
@@ -59,6 +59,14 @@ ozone sh bucket create /volume/bucket
 </property>
 {{< /highlight >}}
 
+<div class="alert alert-warning" role="alert">
+
+提示: 对于 [OM HA]({{< ref "feature/OM-HA.zh.md">}}) 集群，需要指定 ozone service id。例如，
+如果 `ozone.om.service.ids = ozone1`，则 URL 是 `o3fs://bucket.volume.ozone1`。
+对于非 HA，它可以是 `o3fs://bucket.volume`。
+
+</div>
+
 这样会使指定的桶成为 HDFS 的 dfs 命令的默认文件系统，并且将其注册为了 o3fs 文件系统类型。
 
 你还需要将 ozone-filesystem.jar 文件加入 classpath：