diff --git a/otc_metadata/data/services.yaml b/otc_metadata/data/services.yaml
index 66e91661..570cf88a 100644
--- a/otc_metadata/data/services.yaml
+++ b/otc_metadata/data/services.yaml
@@ -484,6 +484,14 @@ documents:
     service_type: ecs
     title: API Reference
     type: api-ref
+  - environment: internal
+    html_location: docs/ecs/best-practise
+    link: /elastic-cloud-server/best-practise/
+    pdf_name: ecs-best-practise
+    rst_location: best-practise/source
+    service_type: ecs
+    title: Best Practise
+    type: best-practise
   - hc_location: devg/ecs
     html_location: docs/ecs/dev
     link: /elastic-cloud-server/dev-guide/
@@ -589,13 +597,13 @@ documents:
     title: API Reference
     type: api-ref
   - environment: internal
-    html_location: docs/fg/umn
-    link: /function-graph/umn/
-    pdf_name: fg-umn
-    rst_location: umn/source
+    html_location: docs/fg/best-practice
+    link: /function-graph/best-practice/
+    pdf_name: fg-best-practice
+    rst_location: best-practice/source
     service_type: fg
-    title: User Guide
-    type: umn
+    title: Best Practice
+    type: best-practice
   - environment: internal
     html_location: docs/fg/dev
     link: /function-graph/dev-guide/
@@ -605,13 +613,13 @@ documents:
     title: Developer's Guide
     type: dev
   - environment: internal
-    html_location: docs/fg/best-practice
-    link: /function-graph/best-practice/
-    pdf_name: fg-best-practice
-    rst_location: best-practice/source
+    html_location: docs/fg/umn
+    link: /function-graph/umn/
+    pdf_name: fg-umn
+    rst_location: umn/source
     service_type: fg
-    title: Best Practice
-    type: best-practice
+    title: User Guide
+    type: umn
   - environment: internal
     hc_location: api/gaussdb
     html_location: docs/gaussdb_mysql/api-ref
@@ -670,6 +678,14 @@ documents:
     service_type: iam
     title: My Credential
     type: mycredential
+  - environment: internal
+    html_location: docs/iam/permissions
+    link: /identity-access-management/permissions/
+    pdf_name: iam-permissions
+    rst_location: doc/permissions/source
+    service_type: iam
+    title: Permissions
+    type: permissions
   - hc_location: api/ims
     html_location: docs/ims/api-ref
     link: /image-management-service/api-ref/