【Shopify最新ニュース2026・開発者向け】顧客アカウントの全画面拡張、2027-01 で event.from が前のページに

2026年11月11日

開発者向けの変更です。

API 2027-01 から、event.from は移動元のページを返します

対象は、顧客アカウントの全画面拡張で使う Navigation API の currententrychange イベント。

掲載は2026年10月31日、開発者向けの Changelog。

出典: Shopify developer changelog「currententrychange now returns the previous page in event.from for customer account full-page extensions」2026年10月31日
https://shopify.dev/changelog/currententrychange-now-returns-the-previous-page-in-event-from-for-customer-account-full-page-extensions

Version: 2027-01
Flags: Breaking API Change／Action required
Tags: Customer Account API／Customer Accounts

Starting in API version 2027-01, in customer account full-page extensions the Navigation API currententrychange event sets event.from to the page the customer navigated away from, instead of the page they navigated to.
（API バージョン 2027-01 から、顧客アカウントの全画面拡張では、Navigation API の currententrychange イベントが event.from に、顧客が移動した先のページではなく、移動する前のページを入れます）

2026-10 以前の event.from は、移動先のページです

2026-10 以前のバージョンでは、from は新しく開いたページを指します。

対象のターゲットは2つ。

customer-account.page.render
customer-account.order.page.render

In API version 2026-10 and earlier, from is the new entry instead, the same value as shopify.navigation.currentEntry. Starting in 2027-01, from is the previous entry.
（API バージョン 2026-10 以前では、from は新しい履歴の項目で、shopify.navigation.currentEntry と同じ値です。2027-01 からは、from は1つ前の項目になります）

ドキュメント上の from は、もともと「1つ前の履歴」という説明。

2027-01 で、動きがその説明に合う形です。

影響を受けるのは、event.from で移動先を読む拡張です

当てはまるのは、2027-01 以降の全画面拡張で、event.from から移動先を探しているもの。

Full-page extensions on API version 2027-01 or later that use event.from to find the page the customer navigated to are affected.
（API バージョン 2027-01 以降の全画面拡張で、顧客が移動した先のページを event.from で探しているものが影響を受けます）

対象外も、原文ははっきり書いています。

2026-10 以前のバージョンに留まる拡張
shopify.navigation.currentEntry を読んでいる拡張（どのバージョンでも影響なし）
useNavigationCurrentEntry hook を使っている拡張（どのバージョンでも影響なし）

壊れ方の例は、ルートの表示。

For example, an extension that chooses which route to render from event.from keeps showing the previous route after each navigation.
（たとえば、表示するルートを event.from で決めている拡張は、移動のたびに1つ前のルートを表示し続けます）

移行は、currentEntry を読む形への書き換えです

直し方は、event.from.url を shopify.navigation.currentEntry.url に置き換えること。

原文の書き換え前のコード。

shopify.navigation.addEventListener('currententrychange', (event) => {
setPath(new URL(event.from.url).pathname);
});

書き換え後のコード。

shopify.navigation.addEventListener('currententrychange', () => {
setPath(new URL(shopify.navigation.currentEntry.url).pathname);
});

書き換え後のコードは、API 2025-10 以降で動きます。

The updated code works on API version 2025-10 and later, so you can make the change before you update your API version.
（書き換えたコードは API バージョン 2025-10 以降で動くので、API バージョンを上げる前に変更できます）

確認の方法も、原文にあります。

To confirm the update, navigate between two routes in your extension and check that each navigation shows the page you navigated to.
（更新を確かめるには、拡張の中で2つのルートを行き来し、移動のたびに移動先のページが表示されることを確かめます）

🔴 公式に書かれていないこと

API バージョン 2027-01 がいつ公開されるかの日付は、この Changelog には書かれていません
2026-10 以前のバージョンがいつまで使えるかは書かれていません
全画面拡張以外の顧客アカウントの拡張や、チェックアウトの拡張に同じ変更があるかは書かれていません
店主の側でやることや、購入者に見える変化があるかは書かれていません
対象になるストアのプランの条件や、日本のストアでの扱いは書かれていません
原文から張られている “Navigation API reference for customer account UI extensions” のリンク先は、本記事では読んでいません
🔴 本記事は日本のストアで確認していません。上の記載が無いことをもって「影響がある」とも「影響がない」とも書きません