diff --git a/_pages/userflow.md b/_pages/userflow.md
index 2e7c3a4995..7e64d85148 100644
--- a/_pages/userflow.md
+++ b/_pages/userflow.md
@@ -26,3 +26,6 @@ layout: post
## Proxy Rebalancing
+## Escrow
+
+
diff --git a/illustrations/Escrow.svg b/illustrations/Escrow.svg
new file mode 100644
index 0000000000..c7212db340
--- /dev/null
+++ b/illustrations/Escrow.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/mermaid_files/Escrow.mmd b/mermaid_files/Escrow.mmd
new file mode 100644
index 0000000000..77b34f024f
--- /dev/null
+++ b/mermaid_files/Escrow.mmd
@@ -0,0 +1,22 @@
+
+sequenceDiagram
+ actor Owner
+ actor User
+ participant Escrow
+ participant Relayer
+
+ Owner ->> Escrow: Deploys escrow and whitelists assets
+ Note over Escrow: Escrow period starts
+ User ->> Escrow: call deposit(std/gov)
+ Note over Escrow: Freeze period starts
+ Owner -->> Escrow: (revoke() in case of error)
+ User -->> Escrow: refund() if revoked
+ Owner ->> Escrow: call setConcentrationAmounts()
(how much to accept from each asset)
+ Owner ->> Escrow: depositToFyde()
(called multiple depending on number of assets)
+ Escrow ->> Relayer: call requestDeposit()
+ Relayer ->> Escrow: mint TRSY/sTRSY
+ Owner ->> Escrow: updateInternalAccounting()
+ Note over Escrow: Freeze period ends /
Claim period starts
+ User -->> Escrow: claimAndRefund()
+ Escrow -->> User: transfer TRSY/sTRSY
refund of unused deposits
+