Skuvera

「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 が参照をチェックする時点でまだ作成されていません。
  • 参照先の商品が、ストアから削除されました。
  • 参照値に誤字があるか、既存の商品と一致していません。

修正方法

  1. メタフィールドの値を残すため、ファイルのコピーを保存します。
  2. インポートするファイルから、商品参照メタフィールドの列の値を取り除きます。
  3. ファイルをインポートします。すべての商品が、参照なしで作成されます。
  4. CSV でメタフィールドの値を復元します。
  5. 「Overwrite products with matching handles」を選んで、もう一度インポートします。今度は参照先のすべての商品が存在するため、参照が受け付けられます。

予防方法

  • それらを参照するファイルの前に、新しい商品をインポートします。
  • 参照を含むインポートは、Shopify が推奨するとおり 2 段階で計画します。

ファイルの残りをチェック

この問題自体はインポート前に検出できませんが、Skuvera はブラウザ内で Shopify のその他のルールに照らして商品 CSV をチェックするため、それ以外の問題はまとめて修正できます。無料・登録不要。

よくある質問

なぜ 2 回インポートする必要があるのですか?
Shopify は商品のインポート時に各参照をチェックします。同じファイルの後の方で作られる商品は、その時点ではまだ存在しないため、最初のインポートで商品を作り、2 回目で参照を追加します。
上書きオプションは、他のデータも変更しますか?
CSV に含まれる列の値を、同じ handle の商品に対して置き換えます。ファイルにない列は、現在の値を保ちます。

詳しく見る

Shopify の公式説明を読む

その他のインポートエラー

2026年10月30日 更新