shopify-developer

Shopify 開発者向けリファレンス

プロフェッショナルな Shopify 開発のための包括的なリファレンスです。API バージョン 2026-01 に対応しています。

クイックリファレンス

項目	値
API バージョン	2026-01（安定版）
GraphQL Admin	POST https://{store}.myshopify.com/admin/api/2026-01/graphql.json
Storefront API	POST https://{store}.myshopify.com/api/2026-01/graphql.json
Ajax API（テーマ）	/cart.js、/cart/add.js、/cart/change.js
CLI のインストール	npm install -g @shopify/cli
テーマの開発	shopify theme dev --store {store}.myshopify.com
アプリの開発	shopify app dev
デプロイ	shopify app deploy
ドキュメント	shopify.dev

開発内容を選択する

タスクに該当するリファレンスファイルを確認してください。

Liquid テンプレート - .liquid ファイルの作成またはデバッグ：

• references/liquid-syntax.md - タグ、制御フロー、反復処理、空白、LiquidDoc
• references/liquid-filters.md - 各フィルターカテゴリーと使用例
• references/liquid-objects.md - 商品、コレクション、カート、顧客、グローバルオブジェクト

テーマ開発 - テーマの構築またはカスタマイズ：

• references/theme-development.md - OS 2.0 アーキテクチャ、セクション、ブロック、JSON テンプレート、設定スキーマ

API 統合 - プログラムによるデータの取得または変更：

• references/api-admin.md - GraphQL Admin API（主要）、REST（レガシー）、OAuth、ウェブフック、レート制限
• references/api-storefront.md - Storefront API、Ajax API、カート操作

アプリ開発 - Shopify アプリの構築：

• references/app-development.md - Shopify CLI、拡張機能、Polaris Web Components、App Bridge

サーバーレスロジック - カスタムビジネスルール：

• references/functions.md - Shopify Functions（Scripts に代わる機能）、Rust/JS ターゲット、デプロイ

ヘッドレスコマース - カスタムストアフロント：

• references/hydrogen.md - Hydrogen フレームワーク、React Router 7、Storefront API 統合

最適化とトラブルシューティング：

• references/performance.md - 画像、JS、CSS、フォント、Liquid、Core Web Vitals
• references/debugging.md - Liquid エラー、API エラー、カートの問題、ウェブフックの失敗

廃止に関するお知らせ

廃止予定	置き換え先	期限
Shopify Scripts	Shopify Functions	2025年8月（移行）、終了時期未定
checkout.liquid	Checkout Extensibility	2024年8月（Plus）、完了
REST Admin API	GraphQL Admin API	廃止プロセス進行中（削除日は未定）
レガシーカスタムアプリ	新しい認証モデル	2025年1月（完了）
Polaris React	Polaris Web Components	移行プロセス進行中
Remix（アプリフレームワーク）	React Router 7	Hydrogen 2025.5.0 以降

Liquid の基本

構文の種類は 3 つです。

{{ product.title | upcase }}                    {# Output with filter #}
{% if product.available %}In stock{% endif %}   {# Logic tag #}
{% assign sale = product.price | times: 0.8 %}  {# Assignment #}
{%- if condition -%}Stripped whitespace{%- endif -%}

主なパターン：

{% for product in collection.products limit: 5 %}
  {% render 'product-card', product: product %}
{% endfor %}

{% paginate collection.products by 12 %}
  {% for product in paginate.collection.products %}...{% endfor %}
  {{ paginate | default_pagination }}
{% endpaginate %}

API の基本

// GraphQL Admin - always use GraphQL over REST
const response = await fetch(
  `https://${store}.myshopify.com/admin/api/2026-01/graphql.json`,
  {
    method: 'POST',
    headers: {
      'X-Shopify-Access-Token': accessToken,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ query, variables }),
  }
);
const { data, errors } = await response.json();
if (errors) throw new Error(errors[0].message);

// Ajax API (theme-only cart operations)
fetch('/cart/add.js', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ id: variantId, quantity: 1 }),
});

リファレンスファイル

ファイル	行数	内容
liquid-syntax.md	~600	タグ、制御フロー、反復処理、変数、空白文字、LiquidDoc
liquid-filters.md	~870	文字列、数値、配列、Shopify 固有、日付、URL、色のフィルター
liquid-objects.md	~695	Shopify オブジェクト全般：商品、バリエーション、コレクション、カート、顧客、注文など
theme-development.md	~1200	ファイル構造、JSON テンプレート、セクション、ブロック、設定スキーマ、レイアウト
api-admin.md	~595	GraphQL クエリ／ミューテーション、REST（レガシー）、OAuth、Webhook、レート制限
api-storefront.md	~235	Storefront API、Ajax API、カート操作、Customer Account API
app-development.md	~760	CLI、アプリのアーキテクチャ、拡張機能、Polaris Web Components、デプロイ
functions.md	~300	Function の種類、Rust／JS ターゲット、CLI ワークフロー、Scripts の移行
hydrogen.md	~375	セットアップ、ルーティング、データ読み込み、Storefront API、デプロイ
performance.md	~605	画像、JS、CSS、フォント、Liquid、サードパーティ製スクリプト、Core Web Vitals
debugging.md	~650	Liquid、JavaScript、API、カート、Webhook、テーマエディターのトラブルシューティング