diff --git a/docs/integrations/commerce/shopify/commerce-shopify-custom-apps.md b/docs/integrations/commerce/shopify/commerce-shopify-custom-apps.md
index 3e4fdb486..48f2905dd 100644
--- a/docs/integrations/commerce/shopify/commerce-shopify-custom-apps.md
+++ b/docs/integrations/commerce/shopify/commerce-shopify-custom-apps.md
@@ -40,6 +40,13 @@ The UI includes a **Find your Shopify credentials** section that guides the merc
      read_customers, read_inventory, read_orders, read_products,
      read_shopify_payments_payouts, read_shopify_payments_disputes
      ```
+     :::tip Scopes for historical orders
+     By default, `read_orders` retrieves orders up to 60 days before the linking date. To access historical orders older than 60 days, the merchant must also enable the     `read_all_orders` scope in the Access section. In that case, your merchants' app scopes should look like this:
+     ```
+     read_customers, read_inventory, read_orders, read_all_orders, read_products,
+     read_shopify_payments_payouts, read_shopify_payments_disputes
+     ```
+     :::
    - Click **Release**
    - (Optional) Enter a version name and a version message
    - Click **Release**