ヘッドレスチェックアウトSSO パラメータ名変更

8月 09, 2026

HEADLESS / SSO

ヘッドレスチェックアウト
SSOパラメータ名が
sso=silent へ統一

logged_in=true は引き続き動作。ドキュメント・用語の整理が目的。

2026年6月8日、ShopifyはヘッドレスチェックアウトにおけるサイレントSSO（シングルサインオン）の公式クエリパラメータ表記を logged_in=true から sso=silent へ統一しました。これはドキュメントと用語の整理を目的としたもので、既存の実装に破壊的変更はありません。今後Shopify公式ドキュメントやサンプルコードでは sso=silent が使用されます。

WHAT CHANGED

01変更の全体像：何が変わり、何が変わらないか

USE CASES

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

課題: ヘッドレスストアフロントで logged_in=true を使って実装済みのチェックアウトリンク生成ロジックがあるが、今後のShopify公式ドキュメントと表記が乖離し、社内引き継ぎや新メンバーが混乱するリスクがある。
打ち手: コードベースを sso=silent に順次置き換え、コメントや変数名も統一することで公式ドキュメントとの一致を保つ。
効果: ドキュメント参照時の混乱を防ぎ、オンボーディングコストを削減。コードレビュー時に用語の一貫性が担保される。
技術メモ: 動作は同一のため、段階的に置き換えても問題なし。既存URL ?logged_in=true は引き続き有効なので、リリースを急ぐ必要はない。

課題: 新規にヘッドレスチェックアウトを構築するプロジェクトで、Shopify公式ドキュメントと古いブログ記事・フォーラム回答が混在し、正しいパラメータがどちらか判断できない。
打ち手: 今後の新規実装では必ず sso=silent を採用する。公式Docsが sso=silent に統一されたため、ドキュメントを正として実装を進められる。
効果: 技術的負債を生まず、将来的なShopify側の変更にも追従しやすい実装が可能となる。
技術メモ: Shopifyのサンプルコードや公式Storefront APIドキュメントが sso=silent 表記に統一されているため、公式ドキュメントを正として参照できる。

課題: パートナー企業や代理店として、複数クライアントのヘッドレスShopify実装を管理しており、ドキュメントとコードのパラメータ表記が異なることで、監査・運用レポート作成時に確認コストが発生する。
打ち手: 各クライアントのコードベースに対して logged_in=true を検索し、 sso=silent への置き換えチケットを起票してメンテナンス対応を計画する。
効果: コードベースの用語を公式に揃えることで、Shopify Docsとの整合性が保たれ、将来の移行コストを低減できる。
技術メモ: grep / ripgrep で logged_in=true を横断検索し影響範囲を洗い出すと効率的。CI上でのリンターチェック追加も検討に値する。