說明
登入

使用 CSV 檔匯入與匯出商品

您可以使用 CSV (逗號分隔值) 檔案將商品匯入 Shopify 商店，或從商店匯出。使用 CSV 檔案可同時匯入或匯出大量商品及其詳細資料，方便您在 Shopify 與其他平台之間交換商品資訊。

若要進一步瞭解如何使用 CSV 檔案，請參閱 open and edit a CSV file。

本頁內容

下載範例 CSV 檔案

您可以下載並查看 sample product CSV file，作為範本使用。使用此範例檔案時，請注意下列事項：

  • 範例檔包含兩個範例商品，並含有部分子類。您的匯入檔可能會包含更多商品與子類。若您以此範例檔建立自己的匯入檔，請務必先移除所有範例商品。
  • 範例檔案包含 Inventory quantity 欄，僅適用於只有單一地點的商店。若您使用多個 locations，且想匯入或匯出庫存數量，請使用 inventory CSV file。
  • 範例檔案包含 Price / International 與 Compare-at price / International 欄位，但由於範例商品在國際銷售時沒有獨立定價，因此這些欄位會留白。瞭解詳情：International CSV columns。

產品 CSV 檔注意事項

在使用產品 CSV 檔案之前，請先閱讀以下注意事項。

設定產品 CSV 檔格式

為確保您的產品 CSV 檔能正確運作，請確認其符合下列條件：

  • 商品 CSV 檔案的第一列必須為欄位標題，且需符合 product CSV description table 的規範。
  • 各欄之間必須以逗號分隔。

產品 CSV 檔的必填欄位

在下列情況下，這些欄位必須存在：

  • 在建立商品 CSV 檔案以匯入新商品時，必填的欄只有 Title。如果要為商品新增子類，則 URL handle 欄也是必填。
  • 使用 CSV 檔案更新商品時，必填的欄位只有 URL handle 與 Title。

資料相依性

即使只有 Title 與 URL handle 這些欄是使用 CSV 檔案更新商品時的唯一必填欄，部分欄位的資料仍會依賴其他欄位的資料。

例如，如果您更新與子類相關的欄位，例如 SKU 或 Weight value (grams)，則這些欄位中的資料會依賴對應子類的資料。在此情況下，您也必須包含 Option1 name 與 Option1 value 欄。

International CSV 欄位

如果您已在商店中設定 Markets，匯出的 CSV 會反映您所建立的市場。預設您的 CSV 會包含下列欄：

  • Included / [Primary]，其中 [Primary] 會替換為您的 primary market 名稱。
  • Included / International
  • Price / International
  • Compare-at price / International

如果您以自有市場取代國際市場，欄位標題中的 International 會改為該市場名稱。

例如，若您為各洲建立市場，其中一個市場名稱為 South America，則在 CSV 匯出檔中的欄位標題會調整如下：

  • Included / International 會變為 Included / South America
  • Price / International 會變成 Price / South America
  • Compare-at price / International 會變成 Compare-at price / South America

CSV 欄中的中繼欄位

使用 CSV 檔案大量匯入/匯出商品時，支援商品中繼欄位。定義商品中繼欄位後，系統會在商品 CSV 匯出中包含該欄位。欄位標題格式為：<name>（product.metafields.<namespace>.<key>）。也可使用 product.metafields.<namespace>.<key>。例如，Fabric 中繼欄位的格式如下：Fabric (product.metafields.shopify.fabric)，或不含名稱與括號時為 product.metafields.shopify.fabric。您可以在 設定 > 自訂資料 > 商品 > 中繼欄位 中找到中繼欄位的命名空間與鍵。瞭解詳情：product metafields。

產品 CSV 匯入/匯出也支援選項值。使用 Option LinkedTo 欄位將選項連結到中繼欄位，接著即可在相對應的 Option values 欄位中使用 metaobject 的值。

子類中繼欄位

商品 CSV 匯入/匯出不支援子類中繼欄位。若要大量編輯子類中繼欄位，您需要使用子類大量編輯器，然後新增中繼欄位的欄位。瞭解詳情：editing variant details in bulk。

產品 CSV 檔欄位說明

下列表格列出產品 CSV 內所有可能的欄位。

除了 Title 欄之外，部分欄位也必須有值。下表已標註必填欄。這些欄若留白或從 CSV 檔案省略，系統會建立預設值。

產品 CSV 檔的欄位

產品 CSV 檔中必須填值的欄位，以及未提供值時系統自動建立的預設值。
欄說明 (含空白儲存格的預設行為)
Title您要顯示給顧客看的商品名稱。例如， Women's Snowboard。
URL handle每個商品的唯一識別碼。網址控制代碼會用於產品頁面的網址，並以 Title 欄的值為基礎。例如，若 Title 欄的值為 Black Sunglasses，則 URL handle 欄的值為 black-sunglasses 做為預設值。若您希望產品頁面網址與商品名稱不同，您可以自訂網址控制代碼值。

有效的網址控制代碼可包含字母、連字號與數字，但不能包含任何空格。
Description商品的 說明，用來提供商品的詳情。
Vendor您販售商品的來源或品牌名稱。若商品為您自製，Vendor 欄的值應與您登入 Shopify 時使用的商店名稱相同。

瞭解 managing vendor information。

Product category

用來描述商品類型的標籤，並用於在美國計算稅率。標籤必須取自 Shopify's Standard Product Taxonomy。

有效的標準化商品類別可透過以下任一方式識別：

  • 完整的類別頁面路徑，例如 Home & Garden > Linens & Bedding > Bedding > Bed Sheets
  • 類別 ID，例如 hg-15-1-2
Type

除 Shopify 的標準類別外，若您需要自訂類別來整理商品，可用此標籤來描述商品。例如，若商品類別是 Bed Sheets，合適的產品類型可以是 Cooling sheets。此標籤不需遵循任何預先定義的格式。

瞭解詳情：新增 產品類型。

Tags

新增關鍵字以協助顧客在線上找到您的商品，或用於商品分組與篩選：

  • 僅使用字母、數字與連字號
  • 同一個儲存格中的標籤請以逗號分隔。例如， Fall-2023, casual, vintage
  • 每個商品最多可新增 250 個標籤
  • 避免使用重音字母與特殊符號

大多數試算表 app 會自動在標籤外加上引號。若您使用純文字編輯器，則需手動加入引號。例如， tag1, tag2, tag3。

瞭解詳情：標籤格式。

Published on online store

指定商品是否要發佈到您的網路商店銷售管道。有效值為：

  • true (預設)：匯入的商品會在網路商店顯示，且可販售
  • false：匯入的商品不會在網路商店顯示

瞭解詳情：發佈到網路商店。

Status

此欄位用來標示商品是否可提供給顧客。若此欄位存在，則必須填入值。若此欄位不存在，商品狀態會自動上傳為 active。有效的值如下：

  • active (預設)：商品已可販售
  • draft：商品尚未可販售
  • archived：商品已不再販售

瞭解詳情：商品狀態。

SKU

子類的存貨單位 (SKU)，用於追蹤 庫存。若您使用 自訂出貨服務，SKU 欄不可留白。

Barcode

子類的條碼、國際標準書號 (ISBN) 或通用產品代碼 (UPC)。

瞭解詳情：庫存代碼。

Option1 name

若商品有多個選項 (例如尺寸或顏色)，請輸入選項名稱以建立子類。商品每一種選項名稱與數值的組合都可以是該商品的一種子類，例如 Size 或 Color。

每個商品最多可有 3 個選項。

若商品只有一個選項，則此值應為 Default Title。

瞭解詳情：建立子類。

Option1 value

若商品有多個選項 (例如尺寸或顏色)，請輸入其數值。例如，顏色選項的數值可以是 Black。每個商品最多可有 3 個選項。

若透過 LinkedTo 欄位將選項連結到類別中繼欄位，則選項值可以是 metaobject 控制代碼或 GID (而非顯示名稱)。

警告：變更此欄位的資料會刪除現有的子類 ID 值並建立新的子類 ID。任何子類 ID 值的變動都可能破壞第三方對子類 ID 的相依。

瞭解詳情：建立商品 子類。

Option1 LinkedTo若商品選項已連結至類別中繼欄位，則此值應為 product.metafields.shopify.{taxonomy_attribute}
Price

商品或子類的價格。僅輸入金額，不含幣別符號。例如， 9.99。預設值為 0.00 ，若未輸入值。

瞭解詳情：商品價格。

Price / International

在同名市場中，以該市場的幣別設定此商品的固定價格。

瞭解詳情：適用於 International 的 CSV 欄位。

Compare-at price

若價格已下調且您想顯示價格比較，請輸入子類的原價。僅輸入金額，不含幣別符號。例如， 9.99。

瞭解詳情：設定比較於價格。

Compare-at price / International

在同名市場中，以該市場的幣別為此商品設定固定的原價。要使用固定原價，該商品必須在該市場先設有固定價格。

瞭解詳情：適用於 International 的 CSV 欄位。

Cost per item

製造或取得該商品或子類的成本。僅填入金額，不要包含貨幣符號，例如 9.99。

瞭解詳情：設定 每件成本。

Charge tax

若商品須課稅，請設定 依地點計稅。有效的值如下：

  • true (預設)：對商品或子類收取稅額
  • false：不對商品或子類收取稅額
Inventory tracker

指定要用來追蹤子類庫存的服務。有效值包括：

  • shopify
  • shipwire
  • amazon_marketplace_web
  • 未追蹤庫存時留白

如果移除了現有的庫存追蹤選項，系統就不再追蹤庫存。

第三方出貨服務：針對庫存位於第三方出貨服務的子類，匯出的 CSV 會顯示 shopify 於此欄中 (啟用庫存追蹤時)，若未啟用則為空白。您的庫存量和地點指派維持不變。若要管理特定出貨服務地點的庫存，請使用庫存 CSV 檔案。如果您有配合的開發人員，也可以改用 Inventory API。

Inventory quantity

該商品或子類可售的庫存數量。此欄僅適用於僅有單一地點的 Shopify 商店。

預設值為 0 ，若未輸入值。

瞭解詳情：管理可用庫存。

Continue selling when out of stock

指定是否允許顧客購買無庫存品項。有效值為：

  • deny (預設)：庫存量達 0 後，系統不允許購買該子類。
  • continue：允許在子類庫存量達 0 後仍可購買，隨後會顯示負庫存量。

瞭解詳情：銷售無庫存商品。

Weight value (grams)

商品或子類的重量，以公克為單位。

只需填入數值，不要包含單位或小數。例如，若您的子類重量為： 5.125 公斤，請輸入 5125。 若為 4 磅，請輸入 1814。

預設值為 0 ，若未輸入值。

如果您使用運費試算（依承運商計算）或第三方出貨服務，請務必填入正確的重量。

Weight unit for display

您希望在商店中顯示的商品重量單位。

有效值如下：

  • g
  • kg (預設)
  • lb
  • oz
Requires shipping

用來指定此商品是否為實體商品（例如非數位商品），因此必須運送。有效值如下：

  • true (預設)：需要運送
  • false：不需要運送

瞭解詳情：運送詳情。

Fulfillment service

您為商品或子類使用的出貨服務。有效值如下：

  • manual (預設)
  • shipwire
  • webgistix
  • amazon_marketplace_web

若您使用自訂出貨服務，請依下列規範在此欄輸入服務名稱：

  • 僅使用小寫字母
  • 以連字號 (-) 取代空格
  • 移除句點與其他特殊字元

例如，若您的出貨服務名稱為「Joan's Fulfillment」，請輸入 joans-fulfillment 在 CSV 檔案中。

您必須先在 Shopify 管理介面中設定 自訂出貨服務，才能在此欄位中加入該服務名稱。

第三方出貨服務：針對庫存位於第三方出貨服務的子類，匯出的 CSV 會顯示 manual 於此欄中。禮品卡子類則會顯示 gift_card 。您的出貨服務與地點指派會維持不變。

匯入 CSV 時，如果將此欄設定為特定的出貨服務控制代碼 (例如 joans-fulfillment)，即會啟用該子類位於該出貨服務地點的庫存。該子類目前存有庫存的其他任何地點，都仍會保留庫存，不會有任何庫存遭到清空。匯入後，此欄將繼續顯示 manual (當重新匯出這些子類時)。若要直接管理特定出貨服務地點的庫存，請匯入庫存 CSV 檔案。如果您有配合的開發人員，也可以改用 Inventory API。

Included / [Primary]

若您有國際銷售，此欄位會標示商品是否包含在您的主要市場的銷售範圍內。預設值為 true。

此欄位標題名稱會依您在 International 中設定為主要市場的國家/地區而異。若您變更預設主要市場，欄位標題會顯示為新的市場名稱。更多資訊請參閱注意事項。

Included / International

若您有國際銷售，此欄位會標示商品是否可在您的國際市場販售。預設值為 true。

此欄位標題名稱會依您在商店中設定的 International 而異。預設市場為 International。若您變更預設市場或新增任何市場，欄位標題會顯示為那些市場名稱。更多資訊請參閱注意事項。

Product image URL

輸入產品圖片的網址。Shopify 會在匯入時下載這些圖片，並重新上傳到您的商店。

請確認圖片檔名：

  • 不可再更改：圖片上傳到您的商店後便無法編輯
  • 不包含 _thumb、 _small、或 _medium 字尾

此欄位不是子類專用。請使用 子類圖片欄位 新增子類圖片。

Image position

輸入圖片在產品頁面顯示順序的序號。圖片會依序號遞增顯示，從 1 開始。例如，若您要該圖片在產品頁面中優先顯示，請輸入 1。

Image alt text

替代文字會描述圖片及其代表的商品。若瀏覽器因任何原因無法載入圖片，則會改為顯示替代文字。輔助技術也會使用替代文字，向使用螢幕閱讀器等工具的視覺障礙顧客描述圖片。加入替代文字可提升您網站的 SEO。

替代文字請力求精簡且具描述性：

  • 最大長度為 512 個字元
  • 最佳長度為不超過 125 個字元
Variant image URL

輸入子類圖片的網址。請確認新增的網址可正確開啟圖片。

Gift card

用來指定此商品是否為禮品卡。有效值如下：

  • false (預設)：商品不是禮品卡
  • true：商品是禮品卡

您也可以使用此欄位批次編輯其他禮品卡詳情，例如 Description 或 Tags，但您無法透過匯入商品 CSV 檔案來建立禮品卡。只能在 Shopify 管理介面中建立並啟用禮品卡。

SEO title

在搜尋引擎結果中顯示的商品名稱。您輸入的 SEO 標題可為英數混合，最多 70 個字元。有效的 SEO 標題需符合下列條件：

  • 英數字元
  • 最多 70 個字元

如果您將此欄位留空，則商品的 Title 會作為商品的搜尋引擎產品資訊頁面標題。

瞭解詳情：editing SEO titles。

SEO description

SEO 說明也會出現在商品詳細資料頁「搜尋引擎收錄預覽」區塊的說明中。您輸入的 SEO 說明可為英數混合，最多 320 個字元。

如果您將此欄位留空，則商品的 Description 會使用該值。

Google Shopping / Google Product Category

如果您目前使用 Google 商品類別，也可以將其用作 Shopify 商品類別。您可以使用商品類別、Google 商品類別，或兩者皆用。請為每個品項提供最明確、最細的類別。

Google 產品類別 (GPC)（google_product_category）使用 Google 的產品分類法。

您可以用下列任一方式輸入 Google 商品類別：

  • 使用完整類別頁面路徑，例如 Apparel & Accessories > Clothing > Clothing Tops > Shirts
  • 使用類別 ID，例如 212
Google Shopping (Unstructured metafield)

欄標題會視所含數值所代表的 Google 購物中繼欄位而有所不同，且前面會加上 Google Shopping / 。產品 CSV 欄標題中包含的中繼欄位如下：

  • Gender
  • Age Group
  • MPN
  • Condition
  • Custom Product
  • Custom Label 0
  • Custom Label 1
  • Custom Label 2
  • Custom Label 3
  • Custom Label 4

Google 購物欄可能會由某些 app 用來將產品同步至 Google Merchant Center，但 Google 與 YouTube 銷售管道不會使用這些中繼欄位。除非有 app 指示您使用，否則可忽略名稱中包含「Google 購物」的中繼欄位值。

Metafields

這些商品中繼欄位會在您的商店中建立。商品中繼欄位定義會在欄標題中顯示為 NAME; (product.metafields.custom.KEY)。以下中繼欄位類型支援以 CSV 進行批次匯入或匯出：

  • 布林值
  • 顏色 (範例： #ff00cc)
  • 日期
  • date_time
  • 規格尺寸 (範例： 25.0cm)
  • list.color (範例： #ff00cc; #cc0000)
  • list.date (範例： 2023-12-02; 2023-12-03)
  • list.date_time (範例： 2023-12-02T09:30:00; 2023-12-03T10:00:00)
  • list.dimension (範例： 10.0cm; 3.0m)
  • list.metaobject_reference (範例： gid://shopify/Metaobject/123; gid://shopify/Metaobject/456 或是 metaobject 控制代碼，例如 blue; red)
  • list.number_decimal (範例： 1.0; 2.1)
  • list.number_integer (範例： 3; 4)
  • list.product_reference (範例： gid://shopify/Product/123; gid://shopify/Product/456 或是商品的網址控制代碼，例如 boots; skis)
  • list.url (範例： http://www.google.com; http://shopify.com)
  • list.volume (範例： 10.0ml; 2.0l)
  • list.weight (範例： 1g; 2.0lb; 3.0 kg)
  • 金額 (範例： 5.99 CAD)
  • multi_line_text_field (範例：
    "Ingredients Flour Water Milk Eggs")
  • number_decimal (範例： 1.0)
  • number_integer (範例： 1)
  • product_reference (範例： gid://shopify/Product/123 或是商品的網址控制代碼，例如 boots)
  • single_line_text_field (範例： single line)
  • url (範例： http://shopify.com)
  • 體積 (範例： 10.0ml)
  • 重量 (範例： 10.0g)

使用匯入的 CSV 檔覆寫商品資料

匯入 CSV 檔時，您可以勾選「Overwrite products with matching handles.」。若勾選此選項，當匯入檔的控制代碼與現有產品清單中的控制代碼相同時，CSV 檔中的值會覆寫現有產品清單相對應欄位的值。若未勾選覆寫選項，則匯入 CSV 時會略過控制代碼相同的商品。

  • 若匯入 CSV 檔中的非必填欄位為空白，產品清單中相對應的值會被覆寫為空白。
    • 例如， Vendor 在您現有的產品清單中的值為 John's Apparel，但 Vendor 欄在您匯入的 CSV 檔案中是空白，則 John's Apparel 會被覆寫為空白。
  • 若匯入的 CSV 檔案未包含非必填欄，但現有產品清單中有該欄位，則產品清單中的值將維持不變。
    • 例如，若 Variant image URL 欄已包含在現有的產品清單中，但未包含在匯入的 CSV 檔案中，則產品清單中的值會維持不變。
  • 若匯入的 CSV 檔包含非必填欄位，但該欄位又依賴於檔案中未包含的其他欄位資料，則現有資料會被刪除或移除。
    • 例如，若匯入的 CSV 檔包含 SKU 欄，但未包含 Option1 value 與 Option1 name 欄，則會刪除該商品的子類選項。
  • 無法使用 CSV 檔案批次刪除商品。若您想批次刪除商品，您可以在管理介面的 Products 區段使用 bulk actions。
  • 無法使用 CSV 檔案批次更新其他銷售管道的商品供貨情況／可用性。瞭解詳情：setting product availability in other sales channels。

Collection 欄位例外

若要在上傳 CSV 檔案時將商品歸入商品系列，您可以在 CSV 檔案的任意位置新增一個欄標題名稱為 Collection。

當您匯出 CSV 檔案時， Collection 欄不會包含在內。

關於 Collection 欄位的說明，此欄位可新增至商品 CSV 匯入檔。
欄說明
Collection

輸入您要將此商品加入的商品系列名稱。

  • 若為現有的自動商品系列，該商品必須符合該系列的條件。
  • 如果該商品系列尚未存在，系統會建立手動商品系列。

每個商品只能加入一個商品系列。

此值可留白。

最長 255 個字元。

瞭解詳情：overwriting existing products 對此欄位資料的影響。

建立產品 CSV 檔案

針對每個商品，您需要先判斷是單一商品，或是含有子類的商品：

  • 單一商品：單一商品不包含子類。若您上傳的商品沒有子類，請在第一列輸入該商品的所有欄位，以及第一張圖片的網址。後續列只需輸入控制代碼與每張額外圖片的網址。
  • 含子類的商品：如果您上傳的商品有子類，請在第一列輸入該商品的所有欄位，以及第一張圖片的網址。後續各列請輸入網址控制代碼。然後略過 Title、 Description、 Vendor、以及 Tags 欄。接著填寫其餘子類的詳情，以及每張圖片的網址。

將所有商品與圖片都新增完成後，請使用 LF 風格的換行字元，將 CSV 檔案儲存為 UTF-8 格式。若您不熟悉編碼，請參閱您所使用的試算表或文字編輯器的說明文件。

若要查看範例 CSV 檔案，請下載此 sample product CSV file，然後在 Google Sheets 或其他試算表程式中開啟。

準備您的圖片

CSV 檔只能包含文字，因此您必須先將所有產品圖片放在既有的網站上。這些圖片網址僅在匯入 CSV 的過程中使用，匯入完成後即可刪除這些網址。

CSV 檔案僅支援使用圖片網址。CSV 不支援 3D 模型與影片，但您可以將其上傳至 Content > Files。瞭解詳情：product media types。

外部來源的圖片網址必須可公開存取。建議將圖片上傳至「內容 > 檔案」，有助於確保您的產品圖片皆正確。

依據您的圖片檔所在位置，採取下列其中一種方式：

  • 如果檔案只在您的電腦上，您必須先將它們上傳到 Shopify 商店的「內容 > 檔案」，或上傳到其他圖片託管服務 (例如 GoDaddy、OneDrive、Dropbox 或 BucketLynx)，再取得其網址。
  • 如果您從其他平台遷移至 Shopify，您可以複製現有的圖片網址，並在 CSV 檔案中使用。
  • 如果商品 CSV 檔案是您在 Shopify 中 exporting 商品所產生，則無需另外處理，因為您的圖片已在您的網站上。

當您備妥每張產品圖片的網址後，即可開始建立 CSV 檔案。

在 CSV 檔案中新增多張產品圖片

您可以在 Shopify 管理介面中上傳更多圖片，並將更多產品圖片新增到 CSV 檔。如果您是透過 CSV 檔建立 Shopify 商店，流程會稍有不同。請先閱讀以下注意事項：

  • 您需要能編輯 CSV 檔案。Shopify 建議使用 Google Sheets 檢視 CSV 檔案的格式化版本。
  • 每個商品最多可新增 250 張圖片。
  • 您的商品圖片必須上傳至可公開存取的網址。也就是說，網址應使用 https:// 通訊協定，且不得啟用密碼保護。您可以前往 Shopify 管理介面的 Files 頁面，upload images。網址會自動產生。按一下 Upload files 後，您可以一次選取多達數百張圖片進行批次上傳。

在 CSV 檔案中加入多張產品圖片

  1. 插入新列。每張圖片僅能使用一列。
  2. 複製並貼上控制代碼。
  3. 複製並貼上圖片網址。

插入新列

  1. 在您的試算表程式中開啟 CSV 檔案，例如 Google Sheets。
  2. 找到您要新增圖片的商品。
  3. 在下一列，按一下並拖曳列號以選取多列。選取的列數需與您要新增的額外圖片數量相同。
    在產品 CSV 的 Google 試算表中，第三列與第四列已反白。
  4. 在反白這些列之後，於反白區域任一處按一下滑鼠右鍵，然後選取 在上方插入 X 列。
    在產品 CSV 的 Google 試算表中，已選取「Insert 2 above」選項。

複製並貼上網址控制代碼的值

將所需商品的網址控制代碼值複製並貼到新列的 A 欄。

在產品 CSV 的 Google 試算表中，第三與第四列的 handle 欄輸入了 black-shirt。

複製並貼上圖片網址

  1. 在 Files 頁面，將圖片上傳到 Shopify。
  2. 按一下 複製連結 圖示，每次複製一個圖片網址。
    在 Shopify 管理介面的「檔案」頁面中，黑色 T 恤圖片所在列的連結按鈕被反白標示。
  3. 在您使用的試算表程式中開啟的 CSV 檔，橫向捲動到最後幾個欄位。
  4. 在 Product image URL 欄，將圖片網址貼到每一列。
    在產品 CSV 的 Google 試算表中，黑色 T 恤的產品圖片網址輸入在 Image Src 欄的一列。
  5. 對此商品的所有圖片重複步驟 2 至 4
  6. 選擇性步驟：為提升 SEO，請在所有 Image alt text 欄位中輸入數值。瞭解詳情：Image alt text。
  7. 儲存 CSV 檔案，然後 import it to Shopify。