ADMIN API

CollectionSortOrderに
MOST_RELEVANT値が追加

APIバージョン2026-07以降でコレクションの「最も関連性の高い順」並び替えが正式サポート

CollectionSortOrder〜 2026-04MOST_RELEVANTなしCollectionSortOrder2026-07 〜+ MOST_RELEVANT ✓

GraphQL Admin APIのCollectionSortOrder列挙型にMOST_RELEVANTが追加されました。APIバージョン2026-07以降で利用可能です。コレクションの並び順を「最も関連性の高い順」でプログラム制御できるようになります。

1変更内容:Before / After 図解

Before(〜2026-04)After(2026-07〜)CollectionSortOrder 列挙値MANUALBEST_SELLINGALPHA_ASC / ALPHA_DESCPRICE_ASC / PRICE_DESCCREATED_ASC / CREATED_DESCMOST_RELEVANT ——CollectionSortOrder 列挙値MANUALBEST_SELLINGALPHA_ASC / ALPHA_DESCPRICE_ASC / PRICE_DESCCREATED_ASC / CREATED_DESCMOST_RELEVANT ✓ NEW

2業務に活かせる具体ユースケース

課題
季節キャンペーンのコレクションで、旬な商品を上位表示させたいが既存の並び順(売れ筋・価格等)では意図通りにならない
打ち手
コレクション更新APIでsortOrder: MOST_RELEVANTを指定し、Shopifyのレリバンス計算に任せた自動並び替えを適用する
効果
手動並び替えの運用コストを削減しつつ、文脈に合った商品順をAPIから設定できる
技術メモ
APIバージョン2026-07以降必須。旧バージョンでは値が存在しないためクエリエラーになる点に注意
課題
複数ストアを管理するマーチャントが、コレクションの並び順をスクリプトで一括変更したいが「関連性順」の選択肢がAPIになかった
打ち手
一括更新スクリプトのCollectionSortOrder引数にMOST_RELEVANTを追加し、管理画面と同等の並び順設定をAPI経由で実現
効果
管理画面手作業が不要となり、多店舗展開の運用効率が向上する
技術メモ
記載なし(Shopify Help Centerのcollection sortingドキュメントで詳細確認を推奨)
課題
カスタムストアフロント(Headless)でコレクション一覧をAPIから取得・表示する際に、「関連性の高い順」を選択できずUX設計が制限されていた
打ち手
Admin APIでMOST_RELEVANTをコレクションに設定し、Storefront APIまたはカスタムロジックで反映された順序を取得する
効果
エンドユーザー向けのコレクション表示が、Shopifyのレリバンスロジックを活用した最適な順序で提供できる
技術メモ
Admin APIとStorefront APIの連携挙動の詳細は公式ドキュメントを要確認

3技術者が押さえるべきポイント

項目 内容
対象API GraphQL Admin API の CollectionSortOrder 列挙型
利用可能バージョン 2026-07 以降(それ以前のバージョンでは値が存在しない)
追加された値 MOST_RELEVANT
既存コードへの影響 既存のCollectionSortOrder利用箇所への後方互換性への直接影響は記載なし。新値を使う場合はバージョン指定の更新が必要
移行・確認手順 APIバージョンを2026-07以上に更新 → クエリ・ミューテーションでMOST_RELEVANTを指定 → Shopify Help Centerで並び順の仕様を確認
注意点 MOST_RELEVANTの具体的なランキングロジックはShopify内部仕様。元記事にはアルゴリズム詳細の記載なし

API Version この変更は 2026-07 以降のAPIバージョンでのみ有効です。バージョンを固定している既存アプリは、MOST_RELEVANTを使う前にバージョン宣言の更新が必要です。

注意 MOST_RELEVANTのレリバンス計算ロジックの詳細は元記事に記載がありません。実際の動作はShopify Help Centerのcollection sortingドキュメントを参照してください。

GraphQL Admin APIでコレクションを「関連性の高い順」に並べ替えできるMOST_RELEVANTが2026-07から利用可能になり、手動運用なしに意図した商品順序をAPIから制御できます。

Source: https://shopify.dev/changelog/added-mostrelevant-value-for-collectionsortorder | 公開日: 2026年4月15日