Shopifyの商品画像の上限は20MBおよび20メガピクセルで、それを超える画像はアプリが自動で縮小します。マッチングの問題の多くは、識別子の重複、空の識別子、ファイル名の小さなミスが原因で、いずれもアップロード前にプレビューで確認できます。
上限
| 上限 | 値 | アプリの動作 |
|---|---|---|
| ファイルサイズ | 20MB（Shopify） | jpg、jpeg、png、webp、gifを縮小・再エンコード。それでも収まらない場合のみ、明確なエラーを表示します。 |
| 解像度 | 20メガピクセル（Shopify） | 約18MPまで縮小して再試行します。 |
| 1商品あたりの画像数 | 250枚（Shopify） | Shopify自体の上限 |
| 無料プラン | 合計25枚 | 「Free upload limit reached」でジョブが停止します。 |
| プレビューの表 | それぞれ5,000行まで表示 | 件数とCSVエクスポートにはすべてが含まれます。 |
| マッチング結果 | 2時間保持 | それ以上経ったら再マッチングしてください。 |
| Shopifyのファイル変更レート制限 | ストア全体に適用 | 自動で待機（3秒 → 6秒 → 12秒）して再試行します。 |
上限を超える画像は、アップロードの前にプレビューページの警告に一覧表示されます。
推奨仕様： JPGまたはWEBP、長辺2048〜4096px、sRGB、5MB未満。
大規模なアップロードにかかる時間
Shopifyは、ストア内のファイルを変更できる速度をストア全体で制限しています。アプリはダウンロードとアップロードを並行して進め、上限に達すると自動で速度を落とすため、大規模なジョブは速くではなく着実に進みます。数万枚の画像なら、数分ではなく数時間を見込んでください。進捗は画像ごとに保存されるので、再起動しても止まったところから再開します。
マッチングの問題
| 症状 | 考えられる原因 | 解決方法 |
|---|---|---|
| 1枚もマッチしない | マッチング方法やフォルダーの選択ミス、またはバリエーションの識別子が空 | Expected SKU列を商品データと比較する |
| 一部の画像がマッチしない | 入力ミス、末尾のスペース、拡張子の欠落、数字以外の末尾 | マッチしなかった画像のCSVをエクスポートし、商品のエクスポートと比較する |
| 画像が間違ったバリエーションにマッチした | 識別子の重複、または「含む」オプションが短いコードに一致 | 完全一致のオプションに切り替えるか、コードを一意にする |
| SKUの重複でマッチ数が少ない | 同じ識別子を持つバリエーションは最初の1つだけが対象 | 複数のバリエーションへのマッチングを依頼するか、識別子を一意にする |
| アクセント付きのタイトルでマッチしない | ファイル名（macOS）とShopifyでアクセントの符号化が異なる | Unicode正規化を依頼するか、SKUでマッチングする |
| 編集した商品が古い値のままマッチする | カタログがキャッシュされている | キャッシュをクリアをクリックする |
| 新しい画像が表示されない | フォルダーの一覧がキャッシュされている | 再マッチングをクリックするか、フォルダー選択を更新する |
| マッチングがタイムアウトする | カタログとフォルダーが非常に大きい | コレクションでの絞り込みを依頼するか、フォルダーを分割する |
アップロード時のメッセージ
| メッセージ | 意味 | 対処 |
|---|---|---|
Image size is larger than 20MB / 20 megapixels | 上限以下に縮小できなかった | 画像を小さく書き出し直す |
hit the Shopify file rate limit; retrying in Ns | Shopifyによる通常の速度制限 | 対処不要。アプリが再試行します |
Your shop reached Shopify API rate limit | 別のアプリやジョブがAPIを使っている | 大きなジョブを同時に2つ実行しない |
Free upload limit reached | 無料の25枚を使い切った | プランをアップグレードする |
This folder already in process | このフォルダーのジョブがまだ実行中 | 終了を待つか停止する |
product has only default variant… | 画像がバリエーションではなく商品に割り当てられた | 想定どおりの動作 |
ジョブがfinished with errorsで終了 | 一部の画像が失敗した | エラー行を確認する。失敗した画像は自動で再試行されます |
試験運用のチェックリスト
- 画像1枚の商品に、バリエーション画像として1枚だけ付いている。
- 画像が複数ある商品に、
_0/_1/_2の順で付いている。 - 複数バリエーションの商品で、各バリエーションに個別の画像が表示される。
- Shopifyの代替テキストがプレビューと一致している。
- わざと間違えたファイル名が、マッチしなかった画像とCSVに表示される。
- テスト商品で置き換えモードを使うと、新しい画像だけが残る。
サポートを受ける
ストアのドメイン、フォルダー名、マッチング方法、実行したおおよその日時、本来マッチするはずだったSKUやバーコードとそのファイル名の例2〜3個を添えて、お問い合わせください。マッチング処理の詳細なトレースを記録し、画像がなぜそのようにマッチしたのかを正確にお伝えできます。