diff --git a/docs/documentation/platform/secret-reference.mdx b/docs/documentation/platform/secret-reference.mdx
index ce9b50db5..8df6fce72 100644
--- a/docs/documentation/platform/secret-reference.mdx
+++ b/docs/documentation/platform/secret-reference.mdx
@@ -1,5 +1,5 @@
 ---
-title: "Reference Secrets"
+title: "Reference/Import Secrets"
 description: "How to use reference secrets in Infisical"
 ---
 
@@ -34,4 +34,16 @@ For instance, to access a secret 'A' composed of secrets 'B' and 'C' from differ
 When using [service tokens](./token) to fetch referenced secrets, ensure the service token has read access to all referenced environments and folders. 
 Without proper permissions, the final secret value may be incomplete.
 
+## Import multiple secrets from a environment secret path
 
+You can import or link another environment's folder to your dashboard to inherit its secrets. This is useful when you need to share secrets across multiple environments.
+
+To add an import/link, just click on `Secret Link` button and provide an `environment` and `secret path` to which the secrets must be pulled. 
+
+![secret import change order](../../images/secret-import-add.png)
+
+The import hierarchy is "last one wins." This means that the order in which you import matters. The last folder you import will override the secrets from any previous folders. Additionally, any secrets you define in your dashboard will override the secrets from any imported folders.
+
+You can change the order by dragging and positioning according using the `Change Order` drag handle.
+
+![secret import change order](../../images/secret-import-change-order.png
diff --git a/docs/images/secret-import-add.png b/docs/images/secret-import-add.png
new file mode 100644
index 000000000..1376fd412
Binary files /dev/null and b/docs/images/secret-import-add.png differ
diff --git a/docs/images/secret-import-change-order.png b/docs/images/secret-import-change-order.png
new file mode 100644
index 000000000..792958d93
Binary files /dev/null and b/docs/images/secret-import-change-order.png differ