建立與啟用指令碼

您在 Shopify Scripts API 中撰寫指令碼。此 API 為 Ruby 程式語言的變體，因此您需要具備 Ruby 程式設計經驗。請使用 Script Editor 來建立、編輯、測試與發布指令碼。

方案需求

自 2026 年 6 月 30 日起，Shopify 指令碼已棄用。任何仍在您商店發佈的指令碼皆已停用且無法再運作。若要重新建立這些自訂，請轉移至 Shopify Functions。瞭解從 Shopify 指令碼轉移至 Shopify Functions 的詳情。

在開始撰寫指令碼之前，請先檢視不同的 指令碼類型 (商品項目、運送與付款)，以瞭解各類型支援的方法。舉例來說，商品項目指令碼無法呼叫屬於運送類型的方法。

每種指令碼類型同一時間只能發布一個指令碼。例如，您可以發布一個商品項目指令碼與一個運費費率指令碼，但不能同時發布兩個商品項目指令碼。

支援的管道

建立 (或編輯) 指令碼時，您可以選擇只在網路商店執行，或在網路商店與下列 app 中執行：

• 使用 Storefront API、JavaScript Buy SDK、Mobile Buy SDKs (Android 與 iOS) 打造的自訂 app
• 可建立結帳頁面的自訂 app
• Tapcart、Plobal Apps 與 Vajro 行動應用程式建立工具

注意

若在指令碼最後一次更新之後才安裝了 app，請重新發布指令碼，以確保它能在新安裝 app 的應用程式背景資訊中如預期執行。

您可以在 Script Editor 提供的 指令碼範本 中找到常見的指令碼範例。若要檢視這些範本，您需要先建立指令碼。

建立指令碼

建立指令碼：

請參閱 Shopify Scripts API，以作為撰寫指令碼的參考。

1. 開啟 Script Editor。指令碼 總覽頁面會顯示您商店的指令碼清單。
2. 按一下建立指令碼，開始建立新指令碼。
3. 在「 選取指令碼範本 」對話方塊中：
   1. 選擇要建立的指令碼類型。
   2. 選擇範例範本作為起點，或選擇空白範本 從頭開始撰寫指令碼。
   3. 按一下「 建立指令碼 」以建立您選擇類型的指令碼。

      提示

      您在此選擇的指令碼類型 (商品項目、運費費率 或 付款閘道) 會決定指令碼的種類，以及可使用的方法。

4. 在 **標題** 欄位輸入指令碼名稱。請使用具描述性的名稱，方便您一眼辨識此指令碼的用途。 5. 按一下 **程式碼** 以開啟 **Ruby 原始碼** 主控台。 6. 輸入指令碼的程式碼。可參考 [Shopify Scripts API 說明文件](/manual/checkout-settings/script-editor/shopify-scripts)。 7. 按一下 **執行指令碼** 以執行指令碼。 8. 完成後： * 按一下 **儲存草稿** 以儲存未發布的指令碼草稿 * 按一下 **儲存並發布** 以建立並發布指令碼。

後續步驟

撰寫完成後，建議先 測試與除錯，再 發布。您也可以 更新您的 Liquid 範本檔案，讓您的線上店面能針對指令碼所做的變更做出對應調整。