CSVGuide2026-10-12

Shopify CSVの「Illegal quoting」を、引用符の事故として直す

約5分で読めます

こんな人向けShopifyの商品CSVでIllegal quotingエラーに遭遇した人
難易度入門

Shopifyの商品CSVでIllegal quotingが出るときに、UTF-8、カンマを含む値、二重引用符の閉じ忘れをテキストとして確認する手順を整理します。

目次を開く

Shopifyの商品CSVで Illegal quoting が出たら、商品名や価格より先にCSVの引用符と文字コードを見ます。Shopify公式ヘルプでは、非UTF-8の文字やカンマ、引用符が絡むCSVでこのエラーが起きるケースを案内しています。

カンマを含む値は引用符で囲む

CSVではカンマが列の区切りです。説明文やタグの中にカンマを入れるなら、その値全体を二重引用符で囲います。

Title,Tags
Mug,"gift,ceramic,white"

途中だけ引用符を付けたり、閉じる引用符が欠けたりすると、次の列まで同じ値だと解釈されます。

値の中の引用符は二重にする

CSVの一般的な規則では、引用符で囲ったフィールド内に " を入れたい場合、"" のように二つ重ねます。

Title,Description
Mug,"He said ""hello"" to the customer"

CSVの不正な引用符と正常なエスケープを比較する図

UTF-8で保存し直して小さく試す

文字化けしたCSVを別の文字コードのまま何度も編集すると、引用符の問題と文字コードの問題が混ざります。UTF-8で別名保存し、数行のテストファイルでインポートを確認してから全件へ戻します。

引用符崩れや列数不一致をアップロード前に機械的に探すなら、CSV Preflightで事前点検できます。

本番投入前の最終チェック

修正したCSVは原本へ上書きせず、テスト用コピーで確認します。ヘッダー行、問題が出ていた代表行、最終行の3か所をテキストでも読み、想定した列数になっているかを見ます。次に少量データでインポートし、取り込み先の画面や処理結果をREADBACKします。

  • 元CSVを残した
  • ヘッダー名を現行仕様と照合した
  • 代表的な問題値を修正後ファイルで確認した
  • 少量テストで期待する項目へ入った
  • 全件処理前に重複・必須値・列数・引用符を確認した

「CSVを保存できた」ではなく、取り込み先で期待した値になったところまでを完了にすると、同じ事故を繰り返しにくくなります。

NEXT

次に読む。

CSV / Guide

Shopify商品CSVはUTF-8で保存する。文字化け後の再保存にも順番がある

約5分

Shopifyの商品CSVが文字化けしたときに、元データの退避、UTF-8での再保存、少数行テストまでを順番に進めて二次破損を防ぐ手順です。

CSV / Guide

CSVの住所や説明文にカンマがあるなら、そのセルだけ引用符で囲む

約5分

CSVの値そのものにカンマが含まれると列がずれる理由と、RFC 4180の基本に沿って二重引用符で1フィールドとして保持する方法を整理します。

CSV / Guide

CSVのセル内に「"」を入れるなら、二重引用符をもう一つ重ねる

約5分

CSVの説明文や商品名に二重引用符を含めたいとき、フィールド全体を引用し、内部の引用符を二つ重ねてエスケープする基本を整理します。

SHARE
XBLUESKYFACEBOOKLINE