「Validation failed: Value must be a valid product reference」というエラーを解消する
CSV 内のメタフィールドが、ストアにまだ存在しない商品を参照しています。まずそのメタフィールドの値なしで商品をインポートし、その後値を戻して「Overwrite products with matching handles」を選んでもう一度インポートしてください。
Shopify のエラーメッセージ
Validation failed: Value must be a valid product reference
このエラーの意味
関連商品や補完商品などの一部のメタフィールドは、別の商品への参照を保存します。Shopify が受け付けるのは、ストアにすでに存在する商品への参照だけです。参照先の商品が同じ CSV で作られる場合や、まったく存在しない場合、インポートはこのエラーで失敗します。
よくある原因
- 参照先の商品が同じファイル内にあり、Shopify が参照をチェックする時点でまだ作成されていません。
- 参照先の商品が、ストアから削除されました。
- 参照値に誤字があるか、既存の商品と一致していません。
修正方法
- メタフィールドの値を残すため、ファイルのコピーを保存します。
- インポートするファイルから、商品参照メタフィールドの列の値を取り除きます。
- ファイルをインポートします。すべての商品が、参照なしで作成されます。
- CSV でメタフィールドの値を復元します。
- 「Overwrite products with matching handles」を選んで、もう一度インポートします。今度は参照先のすべての商品が存在するため、参照が受け付けられます。
予防方法
- それらを参照するファイルの前に、新しい商品をインポートします。
- 参照を含むインポートは、Shopify が推奨するとおり 2 段階で計画します。
ファイルの残りをチェック
この問題自体はインポート前に検出できませんが、Skuvera はブラウザ内で Shopify のその他のルールに照らして商品 CSV をチェックするため、それ以外の問題はまとめて修正できます。無料・登録不要。
よくある質問
- なぜ 2 回インポートする必要があるのですか?
- Shopify は商品のインポート時に各参照をチェックします。同じファイルの後の方で作られる商品は、その時点ではまだ存在しないため、最初のインポートで商品を作り、2 回目で参照を追加します。
- 上書きオプションは、他のデータも変更しますか?
- CSV に含まれる列の値を、同じ handle の商品に対して置き換えます。ファイルにない列は、現在の値を保ちます。
詳しく見る
Shopify の公式説明を読むその他のインポートエラー
2026年10月30日 更新
Skuvera