Enabling `read_all_orders` Scope for Importing Orders Older Than 60 Days

By default, Shopify’s API only returns orders from the last 60 days. To import orders older than 60 days, the read_all_orders scope must be added to your Shopify app.

This page is for the partner-linked token flow in v17:

Path B — Generate Token for a Partner-Linked App

Note: This step is only required if you need to import orders older than 60 days. If you do not need this, you can skip this page.

Step 1 — Complete Partner Prerequisites First

Before you request or enable read_all_orders, complete these prerequisites in your partner-linked app:

Configure Distribution for the app (Meaning Your app must be installed in the store).

Until these are completed, Shopify may not show the read_all_orders access option.

Step 2 — Check Whether `read_all_orders` Is Available (After App Installation)

Use this step after your app is installed in the store and your base setup/token flow is already completed.

App Already Released (version is read-only)

Once a version is released it becomes read-only — you cannot view or edit its scopes directly. You must create a new version to inspect or change the scopes.

Open your app in the Shopify Dev Dashboard.
Go to Versions and click Create version.
The new draft version will be pre-filled with all the scopes from the previously released version.
Click Select scopes to open the scope picker.
In the search box, type read_all_orders and check whether it appears in the results.

Note: Do not release this new version yet — wait until you have confirmed the correct path and added read_all_orders if needed.

If read_all_orders appears → follow B2 from Step 3 below.
If read_all_orders does not appear → follow Path B2 below.

Partner-Linked Flow

This applies when your app (created from the Shopify developer dashboard) is installed through Distribution / Custom Distribution and behaves as a partner-linked app. In this case, read_all_orders requires explicit access approval from Shopify before it becomes available in the scope picker.

After the app is installed and token setup is done, follow:

B2 — App already released and token already generated

B2 — App Already Released and Token Already Generated

Follow these steps if your app is already live and you have an existing access token. The existing token will continue to work after the scope update — no reinstallation or token regeneration is needed. You only need to create a new version with the updated scope and update the app from the Shopify store.

If read_all_orders is already visible in the scope picker, skip Step 1 and Step 2, then start from Step 3.

Step 1 — Request Access for `read_all_orders`

Log in to the Shopify Partner Dashboard.
In the left sidebar, click Apps and select your app.
In the app menu, go to API access.
Scroll down to the Access requests section and find read_all_orders.
Click Request access next to read_all_orders.
Fill in the business justification in the form (e.g. I want to import older orders into my ERP system) and click Request access.

Step 2 — Wait for Shopify Approval

Once Shopify approves the request, read_all_orders will become available in the scope picker for your app.

Step 3 — Create a New Version and Select the Scope

Important: Released versions are read-only and cannot be edited. You must create a new version to add the updated scope.

Go to your app in the Shopify Dev Dashboard.
Navigate to Versions and click Create version.
The new draft version will be pre-filled with all the scopes from the previously released version.
Click Select scopes to open the scope picker.
In the search box, type read_all_orders.
Select the checkbox next to read_all_orders to add it.
Confirm your selection and close the picker.

Step 4 — Release the New Version

Verify that all existing scopes are still present and read_all_orders is now selected.
Click Release version to publish the new version.

Step 5 — Update the App from Your Shopify Store

After releasing the new version, you need to accept the updated permissions from within your Shopify store.

Log in to your Shopify store admin (e.g., yourstore.myshopify.com/admin).
Go to Settings → Apps and sales channels.
Find your installed app in the list.
Open the app and click on button Open App.
You will see an Update prompt indicating new permissions are available. Click Update and confirm.

Your existing access token remains valid. The same token now includes the read_all_orders scope. No reinstallation or token regeneration is required.

Next Steps

Once read_all_orders is active, you can import orders older than 60 days directly from the Shopify Connector in Odoo:

Go to Shopify → Orders → Import Orders.
Set the date range to include the older orders you need.
Run the import as normal.

Need help? If the access request is not approved or the scope still does not appear after approval, contact Shopify Partner Support.

Enabling read_all_orders Scope for Importing Orders Older Than 60 Days