「Invalid CSV header: missing headers」というエラーを解消する

このエラーの意味

商品 CSV の最初の行はヘッダー行で、Shopify は列をその正確な名前で照合します。Title や URL handle（古いテンプレートでは Handle）などの必須列が欠けていたり、名前の綴りが違っていたりすると、Shopify はファイルを読めず、インポートを停止します。

よくある原因

• ファイルが、Title の代わりに Name など独自の列名を使う別のプラットフォームから来たものです。
• ファイル編集中に、必須の列を削除しました。
• ヘッダーに余分な空白、誤字、または Shopify のテンプレートと違う言い回しがあります。

修正方法

1. Shopify のサンプル商品 CSV をダウンロードするか、ストアから商品を 1 つエクスポートして、正しいヘッダーを確認します。
2. ファイルの最初の行をサンプルと列ごとに比較します。
3. 名前が完全に一致しない列は変更し、欠けている必須列を追加します。
4. 各ヘッダーの先頭や末尾の空白を取り除きます。
5. ファイルを CSV UTF-8 形式で保存し、もう一度インポートします。

例

Handle,Name,Price
wool-scarf,Wool scarf,24.90

URL handle,Title,Price
wool-scarf,Wool scarf,24.90

Name は Shopify の列ではありません。Title に、Handle を URL handle に変更すると、現在のテンプレートと一致します。

予防方法

• 新しいファイルは、手作業でヘッダーを作るのではなく、Shopify のテンプレートまたは新規エクスポートから始めます。
• 各ヘッダーを Shopify の現在の列名および旧列名と比較するバリデーターを使用します。

よくある質問

Variant Price のような古い列名は使えますか？

Shopify は古いテンプレートのファイルも引き続き受け付けますが、すべての列をどちらか一方の形式にそろえてください。1 つのファイルで新旧の名前を混在させると、列を誤って読み込む原因になります。

「Choose column headings」ウィンドウとは何ですか？

ヘッダーが一致しないときに Shopify が表示する画面です。ここで各列を対応付けることもできますが、ファイル内のヘッダーを直す方が、今後のインポートでも確実です。

Skuvera の関連チェック

• Title 列がありません
• URL handle 列がありません
• 認識できない列があります

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

• 「Validation failed: price can't be blank」というエラーを解消する
• 「Validation failed: options are not unique」というエラーを解消する
• 「Ignored line because handle already exists」というエラーを解消する
• 「Ignored line because it did not contain product data」というエラーを解消する
• 「Network error: Unexpected token < in JSON at position 0」というエラーを解消する
• Shopify CSV のインポートエラー