From 0ac3c3ddd148f39592f4f3bcbc432af88c4a110e Mon Sep 17 00:00:00 2001
From: a-diarra <68294452+a-diarra@users.noreply.github.com>
Date: Wed, 1 Apr 2026 15:08:26 +0100
Subject: [PATCH 1/2] Update commerce-shopify-custom-apps.md

Update the docs to ensure that clients who need historical orders have the correct Shopify scopes.
---
 .../commerce/shopify/commerce-shopify-custom-apps.md         | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/docs/integrations/commerce/shopify/commerce-shopify-custom-apps.md b/docs/integrations/commerce/shopify/commerce-shopify-custom-apps.md
index 3e4fdb486..bdb82b1fd 100644
--- a/docs/integrations/commerce/shopify/commerce-shopify-custom-apps.md
+++ b/docs/integrations/commerce/shopify/commerce-shopify-custom-apps.md
@@ -40,6 +40,11 @@ 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
      ```
+     **Note**: By default, `read_orders` retrieves orders up to 60 days prior to 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**

From 65eb5db43bf660b59230c60b5f0c167a293f67ae Mon Sep 17 00:00:00 2001
From: Polina <112084241+pzaichkina@users.noreply.github.com>
Date: Wed, 1 Apr 2026 15:31:29 +0100
Subject: [PATCH 2/2] Update commerce-shopify-custom-apps.md

---
 .../commerce/shopify/commerce-shopify-custom-apps.md          | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/integrations/commerce/shopify/commerce-shopify-custom-apps.md b/docs/integrations/commerce/shopify/commerce-shopify-custom-apps.md
index bdb82b1fd..48f2905dd 100644
--- a/docs/integrations/commerce/shopify/commerce-shopify-custom-apps.md
+++ b/docs/integrations/commerce/shopify/commerce-shopify-custom-apps.md
@@ -40,11 +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
      ```
-     **Note**: By default, `read_orders` retrieves orders up to 60 days prior to 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:
+     :::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**