diff --git a/README.md b/README.md
index 5509e7d1..90c74c45 100644
--- a/README.md
+++ b/README.md
@@ -276,6 +276,8 @@ Please refer to the [release page](https://github.com/actions/checkout/releases/
 
 ## Checkout multiple repos (nested)
 
+Note: the checkout order must be primary _then_ secondary repo checkout.
+
 ```yaml
 - name: Checkout
   uses: actions/checkout@v7
@@ -290,6 +292,8 @@ Please refer to the [release page](https://github.com/actions/checkout/releases/
 
 ## Checkout multiple repos (private)
 
+Note: the checkout order must be primary _then_ secondary repo checkout.
+
 ```yaml
 - name: Checkout
   uses: actions/checkout@v7