Branch8

HubSpot 繁中轉簡中切換設定教學:跨境團隊實作指南

Matt Li
November 15, 2026
12 mins read
HubSpot 繁中轉簡中切換設定教學:跨境團隊實作指南

Key Takeaways

  • 介面語言、CMS 變體、CRM 資料是三個獨立層級,須分別設定
  • 先標對母版語言再建立翻譯變體,否則 hreflang 會出錯
  • 表單下拉選單只翻譯標籤,internal value 一律保持英文
  • 使用 OpenCC 的 tw2sp / s2twp 詞庫設定檔,避免「頭發」類錯字
  • 以繁中為單一來源,簡中由衍生產生,降低版本漂移

在 HubSpot 做繁中轉簡中,核心有三層:使用者介面語言(設定 > 一般 > 語言)、CMS 多語言頁面變體(zh-hant / zh-hans),以及 CRM 資料與範本中的中文字串。只換字形不夠,必須同步處理語系標籤、詞彙在地化與資料一致性。

許多在亞太區擴張的品牌,最初以香港或台灣為基地建置 HubSpot,內容全是繁體中文。當業務延伸到中國大陸、新加坡或馬來西亞的簡體中文受眾時,問題才浮現:頁面語系標錯、電子郵件範本混用兩套字、CRM 裡同一個客戶的公司名在繁簡之間不一致,報表因此拆成兩筆。本文把整個流程拆成可執行的步驟,並附上 HubL、API 與轉換腳本範例。

根據 CSA Research 長期進行的「Can't Read, Won't Buy」調查,約 76% 的線上消費者偏好以母語閱讀產品資訊、40% 不會向非母語網站購買——對中文市場而言,繁簡與用詞差異正是「是否為母語」的判準之一。

繁簡轉換為什麼不只是字形替換?

把「設定」轉成「设置」看似一行程式就能解決,但實務上有四個層次會失真。

第一層:字形對應不是一對一。 繁體「發」與「髮」在簡體同為「发」,反向轉換時容易出錯(「頭髮」變「頭發」)。Unicode CLDR 與 OpenCC 專案都以詞庫而非單字對照來處理這類歧義。

第二層:詞彙在地化。 台灣說「資料庫」、中國大陸說「数据库」;台灣「網路」、大陸「网络」;香港「下載」常見但用語習慣又與台灣不同。單純字形轉換會產出語法正確卻讀起來「不是本地人寫的」文案。OpenCC 提供 tw2sp.json(台灣正體轉簡體並轉換慣用詞)這類設定檔處理這一層。

第三層:語系標籤。 依 IETF BCP 47(W3C 建議採用的語言標籤標準),正確寫法是 zh-Hant、zh-Hans,或加上地區 zh-Hant-TW、zh-Hans-CN、zh-Hant-HK。HubSpot CMS 內部使用 zh-tw、zh-cn、zh-hk 這類代碼,輸出到 HTML lang 屬性時需確認實際值。

第四層:資料一致性。 CRM 裡的公司名稱、地址、產業欄位若一半繁一半簡,去重規則(deduplication)會失效,報表與名單分群也跟著錯。

開始前要備妥什麼?

動手之前先確認以下條件,可以省掉大半的回頭工:

  1. 帳號權限:需要 Super Admin 權限才能更動帳號層級的語言與多語言網域設定;只改個人介面語言則任何使用者都可以。
  2. 訂閱層級:CMS 多語言頁面變體需要 Content Hub(原 CMS Hub)Professional 以上;知識庫多語言需要 Service Hub Professional 以上。實際門檻請以 HubSpot 產品與服務目錄為準。
  3. 網域規劃:決定簡中內容走子目錄(/zh-cn/)、子網域(cn.example.com)還是獨立網域。HubSpot 支援在「設定 > 內容 > 網域與網址」為不同語言指派不同的語言子目錄或子網域。
  4. 詞彙表:準備一份繁簡對照的品牌術語表(產品名、功能名、法律條款用語),這是機器轉換永遠處理不好的部分。
  5. 沙盒環境:Enterprise 方案可使用 Sandbox;若無,至少先在未發佈的頁面與測試清單上操作。
  6. 本機工具:Python 3.10+ 與 opencc-python-reimplemented,用於批次轉換 CRM 匯出檔。
1python3 -m venv venv && source venv/bin/activate
2pip install opencc-python-reimplemented requests

Ready to Transform Your Ecommerce Operations?

Branch8 specializes in ecommerce platform implementation and AI-powered automation solutions. Contact us today to discuss your ecommerce automation strategy.

步驟一:切換 HubSpot 使用者介面語言

這是最常被搜尋、也最容易混淆的一步——介面語言只影響登入者看到的後台,不會改動任何對外內容。

個人層級切換

  1. 點右上角頭像 > Profile & Preferences(個人檔案與偏好設定)。
  2. 在 General(一般)分頁找到 Language(語言)。
  3. 從下拉選單選擇目標語言後儲存,重新整理頁面即生效。

HubSpot 的介面語言清單會隨版本增補,繁體中文與簡體中文的可選狀態請直接在此下拉選單確認,不要依賴舊文章的截圖。若清單中沒有你要的選項,後台仍會以英文顯示,但不影響下方所有對外內容的中文設定。

帳號預設與日期格式

設定 > 一般 > 帳號預設值(Account Defaults) 可設定整個 Portal 的預設語言、時區、日期格式與貨幣。跨境團隊常見錯誤:台北團隊用 yyyy/mm/dd、新加坡團隊用 dd/mm/yyyy,匯出 CSV 後日期欄位被 Excel 解析錯誤。建議統一在帳號預設值設為 ISO 格式,再由各地使用者自行覆寫顯示偏好。

步驟二:建立 CMS 簡體中文頁面變體

HubSpot 的多語言功能是「主頁面 + 語言變體」的架構,而非各自獨立的頁面。

  1. 在 內容 > 網站頁面 中找到要翻譯的繁中主頁面。
  2. 點該頁右側 More(更多) > Add translation(新增翻譯)。
  3. 選擇目標語言(簡體中文 / Chinese - Simplified),HubSpot 會複製一份頁面並建立語言群組關聯。
  4. 若原頁尚未指定語言,系統會要求你先把繁中版標記為 Chinese (Traditional) 或 Chinese (Traditional, Hong Kong)。

關鍵在第 4 步:先把母版語言標對,再建立變體。很多團隊把繁中頁面留在預設的 English,結果 hreflang 全部輸出成 en,Google 因而把簡中與繁中頁視為重複內容。

檢查 hreflang 輸出

HubSpot 會自動為同一語言群組的頁面產出 hreflang 標籤。發佈後用瀏覽器檢視原始碼,應看到類似結構:

1<link rel="alternate" hreflang="zh-tw" href="https://www.example.com/pricing">
2<link rel="alternate" hreflang="zh-cn" href="https://www.example.com/zh-cn/pricing">
3<link rel="alternate" hreflang="zh-hk" href="https://www.example.com/zh-hk/pricing">
4<link rel="alternate" hreflang="x-default" href="https://www.example.com/pricing">

Google Search Central 的國際化文件指出,hreflang 必須雙向互指(A 指向 B,B 也要指向 A),否則會被忽略。HubSpot 的語言群組會自動處理互指,但若你手動在範本插入額外 hreflang,就有可能破壞這個規則。

Ready to Transform Your Ecommerce Operations?

Branch8 specializes in ecommerce platform implementation and AI-powered automation solutions. Contact us today to discuss your ecommerce automation strategy.

步驟三:用 HubL 寫出語言感知的範本

與其維護兩套範本,不如讓一套範本依語言自動切換字串。HubSpot 的 HubL 提供 content.language 變數。

1{% set lang = content.language.languageTag|default('zh-tw') %}
2
3{% if lang in ['zh-cn', 'zh-hans'] %}
4 {% set cta_text = "立即预约演示" %}
5 {% set privacy_text = "隐私政策" %}
6{% else %}
7 {% set cta_text = "立即預約示範" %}
8 {% set privacy_text = "隱私權政策" %}
9{% endif %}
10
11<a class="btn btn--primary" href="{{ cta_url }}">{{ cta_text }}</a>
12<a href="/legal/privacy">{{ privacy_text }}</a>

字串一多就該改用字典,集中在一個 translations.html partial:

1{% set i18n = {
2 "zh-tw": {
3 "nav_products": "產品",
4 "nav_support": "技術支援",
5 "form_submit": "送出"
6 },
7 "zh-cn": {
8 "nav_products": "产品",
9 "nav_support": "技术支持",
10 "form_submit": "提交"
11 }
12} %}
13
14{% set t = i18n[content.language.languageTag]|default(i18n["zh-tw"]) %}
15<nav>{{ t.nav_products }} · {{ t.nav_support }}</nav>

注意 nav_support 的例子:台灣慣用「技術支援」,大陸慣用「技术支持」——這不是字形差異,而是詞彙差異,純轉換工具抓不到。

字體 fallback 也要分語系

繁簡字形在不同系統的預設字體下觀感差異很大。建議在 CSS 中分別指定:

1html[lang^="zh-Hant"], html[lang="zh-tw"], html[lang="zh-hk"] {
2 font-family: "PingFang TC", "Microsoft JhengHei", "Noto Sans TC", sans-serif;
3}
4html[lang^="zh-Hans"], html[lang="zh-cn"] {
5 font-family: "PingFang SC", "Microsoft YaHei", "Noto Sans SC", sans-serif;
6}

Google Fonts 的 Noto 系列為 TC / SC / HK 提供獨立字檔,Google Fonts Knowledge 說明中文字型檔案體積遠大於拉丁字型,因此務必只載入當前語系需要的那一套,並使用 font-display: swap。

步驟四:電子郵件、表單與 CTA 的語言分流

表單

在表單編輯器中,Options(選項) > Language(語言) 可設定系統訊息(必填提示、錯誤訊息)的語言。這與欄位標籤是分開的——標籤要自己改。建議做法:複製一份繁中表單,改名為 [ZH-CN] Demo Request,翻譯所有欄位標籤與下拉選項值,再把系統語言設為簡體中文。

下拉選單的內部值(internal value)務必保持英文或數字,只翻譯顯示標籤。否則同一個「產業」欄位會存進「製造業」與「制造业」兩個不同值,報表立刻分裂。

1Label: 制造业 Internal value: manufacturing
2Label: 製造業 Internal value: manufacturing

電子郵件

Marketing Email 本身沒有像 CMS 頁面那樣的語言變體群組,實務上有兩種做法:

  • A. 兩封獨立郵件 + 清單分流:建立 Preferred Language 聯絡人屬性(下拉選單:繁體中文 / 簡體中文 / English),用工作流程分支寄出對應版本。維護成本高但排版自由度最大。
  • B. 單封郵件 + 個人化權杖條件:在郵件內用 HubL 條件判斷,僅適合短文案。純文字段落可行,整段排版切換則不建議。

A 方案在跨境團隊幾乎是預設解,因為香港、台灣、新加坡的發送時間、優惠條款、法遵附註(個資告知)本來就不同,不只是語言。

訂閱偏好與退訂頁

設定 > 行銷 > 電子郵件 > 訂閱類型,每個訂閱類型可為不同語言設定名稱與說明。退訂頁與訂閱偏好頁同樣支援多語言變體——這常被漏掉,結果簡中用戶收到簡體郵件、點退訂卻跳出繁體頁面。

Ready to Transform Your Ecommerce Operations?

Branch8 specializes in ecommerce platform implementation and AI-powered automation solutions. Contact us today to discuss your ecommerce automation strategy.

步驟五:批次轉換 CRM 既有資料

既有聯絡人與公司資料的繁簡混雜,是報表失真的主因。流程如下。

1. 匯出並檢視

從 CRM > 公司 > 匯出,選擇需要清理的欄位(公司名稱、城市、產業、備註)。

2. 用 OpenCC 做語系判定與轉換

1import csv
2from opencc import OpenCC
3
4# tw2sp: 台灣正體 -> 簡體,並轉換慣用詞彙
5cc_tw2sp = OpenCC('tw2sp')
6# s2twp: 簡體 -> 台灣正體,並轉換慣用詞彙
7cc_s2twp = OpenCC('s2twp')
8
9def detect_script(text: str) -> str:
10 """若轉成簡體後與原文不同,代表原文含繁體字"""
11 if not text:
12 return 'unknown'
13 return 'hant' if OpenCC('t2s').convert(text) != text else 'hans'
14
15with open('companies.csv', newline='', encoding='utf-8-sig') as fin, \
16 open('companies_normalised.csv', 'w', newline='', encoding='utf-8-sig') as fout:
17 reader = csv.DictReader(fin)
18 fields = reader.fieldnames + ['detected_script', 'name_hans', 'name_hant']
19 writer = csv.DictWriter(fout, fieldnames=fields)
20 writer.writeheader()
21 for row in reader:
22 name = row.get('Company name', '')
23 row['detected_script'] = detect_script(name)
24 row['name_hans'] = cc_tw2sp.convert(name)
25 row['name_hant'] = cc_s2twp.convert(name)
26 writer.writerow(row)

重點:不要直接覆寫原欄位。保留原值,另建 name_hans / name_hant 兩個自訂屬性,讓報表與名單依區域選用。公司法定名稱(尤其是在香港公司註冊處或台灣經濟部商業司登記的名稱)屬於法律文件用語,不應被自動轉換後取代。

3. 建立自訂屬性並回寫

用 CRM Objects API v3 建立屬性:

1curl -X POST \
2 'https://api.hubapi.com/crm/v3/properties/companies' \
3 -H "Authorization: Bearer $HUBSPOT_PRIVATE_APP_TOKEN" \
4 -H 'Content-Type: application/json' \
5 -d '{
6 "name": "company_name_hans",
7 "label": "公司名稱(簡體)",
8 "type": "string",
9 "fieldType": "text",
10 "groupName": "companyinformation"
11 }'

回寫建議走 batch update,避免逐筆觸發速率限制:

1curl -X POST \
2 'https://api.hubapi.com/crm/v3/objects/companies/batch/update' \
3 -H "Authorization: Bearer $HUBSPOT_PRIVATE_APP_TOKEN" \
4 -H 'Content-Type: application/json' \
5 -d '{
6 "inputs": [
7 {"id": "7801234567", "properties": {"company_name_hans": "东亚精密制造"}},
8 {"id": "7801234568", "properties": {"company_name_hans": "南洋物流集团"}}
9 ]
10 }'

HubSpot 開發者文件說明 batch endpoint 每次請求上限為 100 筆物件,並對 Private App 套用每秒請求數限制;大量資料請在腳本中加入指數退避(exponential backoff)處理 429 回應。

步驟六:知識庫、聊天機器人與客服內容

知識庫:Service Hub 的知識庫支援多語言版本,在「設定 > 知識庫 > 多語言」新增語言後,每篇文章可建立對應變體,並自動在文章頁顯示語言切換器。簡中與繁中文章建議共用同一組 URL 結構(/kb/zh-cn/...、/kb/zh-tw/...),方便日後做搜尋分析。

Chatflow:聊天流程本身不支援語言變體,需為每個語言建立獨立 chatflow,並在「Target(目標)」規則中以頁面網址條件分流:

1Show chatflow when: Website URL contains /zh-cn/

客服信箱與工單:工單狀態、管道名稱等內部欄位保持英文 internal value,只翻譯對外顯示的自動回覆範本。香港團隊同時服務繁中、簡中與英文客戶時,建議以 Ticket language 屬性路由到對應語言的客服隊列,而不是建立三套獨立 pipeline。

Ready to Transform Your Ecommerce Operations?

Branch8 specializes in ecommerce platform implementation and AI-powered automation solutions. Contact us today to discuss your ecommerce automation strategy.

用 LLM 輔助轉換,但要設護欄

2026 年多數團隊已不再純手工翻譯。可行的分工是:OpenCC 處理字形、LLM 處理詞彙在地化與語氣、人類處理品牌術語與法遵文字。

一個實用的 prompt 骨架:

1你是中文在地化編輯。將以下台灣繁體中文行銷文案改寫為中國大陸簡體中文。
2規則:
31. 使用大陸慣用詞彙(例:軟體->软件、網路->网络、支援->支持、示範->演示)
42. 以下品牌術語不得翻譯或改寫:{GLOSSARY}
53. 保留所有 HubL 標籤({{ }} 與 {% %})與 HTML 標籤原樣不動
64. 不得新增原文沒有的功能宣稱或數字
75. 輸出僅包含改寫後文案,不要解釋
8原文:
9{SOURCE}

第 3 與第 4 條是必要的護欄:LLM 很容易「順手美化」HubL 變數名稱,或把「協助提升效率」寫成「提升 30% 效率」這類無來源的宣稱。建議在 CI 中加一道檢查,比對轉換前後 HubL 權杖數量是否一致:

1diff <(grep -o '{{[^}]*}}' source.html | sort) \
2 <(grep -o '{{[^}]*}}' translated.html | sort) \
3 && echo "OK: tokens match" || echo "FAIL: token mismatch"

Branch8 曾為一家以台北為行銷總部、在東南亞設有經銷通路的製造業客戶重整 HubSpot 多語言架構:原本繁中與簡中各自一套獨立頁面與表單,導致同一位採購在報表中被計為兩筆。做法是把頁面收攏為語言群組、表單下拉值統一為英文 internal value、並以 OpenCC + 人工詞彙表清理公司名稱欄位。機制上的改變很單純——讓「語言」成為顯示層屬性,而不是資料層的分岔。

常見問題排除

頁面發佈後 hreflang 沒有出現

多半是語言變體未被正確群組。到頁面清單切換為「依語言檢視」,確認兩個頁面顯示在同一群組底下。若主頁面語言為空白,先設定語言再重新發佈。

中文在電子郵件中顯示亂碼

檢查郵件範本是否被自貼上的 HTML 覆寫了字元集宣告。HubSpot 預設以 UTF-8 輸出;若你貼入含 <meta charset="big5"> 或 gb2312 的舊範本片段,部分客戶端會解析錯誤。移除該宣告即可。

匯入 CSV 後中文變成問號或亂碼

Excel 另存 CSV 時預設可能使用本地編碼(Big5 / GBK)。請以 UTF-8 with BOM 另存(Python 中即 encoding='utf-8-sig'),HubSpot 匯入工具才能正確解析。

轉換後出現「頭發」「干燥」這類錯字

這是單字對照工具的典型失誤。改用 OpenCC 的 s2twp / tw2sp 設定檔(含詞庫),而非 s2t / t2s,並把高風險詞(發/髮、干/乾/幹、后/後、面/麵)加入人工複查清單。

搜尋引擎仍把簡中頁當重複內容

確認三件事:hreflang 雙向互指、canonical 指向自身而非繁中版、簡中頁面未被 noindex。HubSpot 頁面設定中的「進階選項 > Canonical URL」若被手動填成繁中網址,就會抵銷整個多語言設定。

工作流程寄錯語言版本

檢查 Preferred Language 屬性的填值來源。若來自表單隱藏欄位,確認該欄位在簡中表單上的預設值確實是簡中代碼;常見錯誤是複製繁中表單後忘了改隱藏欄位的預設值。

Ready to Transform Your Ecommerce Operations?

Branch8 specializes in ecommerce platform implementation and AI-powered automation solutions. Contact us today to discuss your ecommerce automation strategy.

跨時區維運這套架構的實務建議

多語言設定最難的不是初次建置,而是之後每一次內容更新都要同步兩三個版本。幾個可降低漂移的做法:

  • 以繁中為單一來源(single source of truth),簡中一律由繁中衍生,不允許直接編輯簡中版再反推。
  • 在 HubSpot 建立「待翻譯」工作流程:繁中頁面更新時自動建立任務指派給在地編輯。
  • 善用時區落差:台北或香港白天完成內容撰寫與 HubL 調整,新加坡或馬來西亞團隊下午接手在地化審稿,澳洲團隊在歐美時段處理發佈前檢查——跨市場團隊的時區覆蓋,本身就是縮短發佈週期的結構性優勢,而非單純的人力配置問題。
  • 版本控管範本:用 HubSpot CLI 把 @marketing 與自訂模組同步到 Git。
1npm install -g @hubspot/cli
2hs init
3hs fetch design-manager/templates ./local-templates
4# 編輯後上傳
5hs upload ./local-templates design-manager/templates

把範本納入 Git 後,繁簡字串字典的每一次修改都有 diff 可追,比在 Design Manager 裡直接改安全得多。

若你的團隊同時要服務台灣、香港、中國大陸與東南亞華語市場,又希望由一個 HubSpot Portal 統一管理,Branch8 在香港、台北、新加坡與吉隆坡的團隊可協助規劃語言架構、資料正規化與 CI 流程。歡迎與我們聯絡,討論你目前的 Portal 結構與遷移順序。

Sources

FAQ

HubSpot 的介面語言在「個人檔案與偏好設定 > 一般 > 語言」中切換,可選清單會隨版本更新,建議直接在下拉選單確認目前是否提供中文選項。即使後台仍顯示英文,也完全不影響你對外網頁、郵件與表單的中文內容設定。

About the Author

Matt Li

Co-Founder & CEO, Branch8 & Second Talent

Matt Li is Co-Founder and CEO of Branch8, a Y Combinator-backed (S15) Adobe Solution Partner and e-commerce consultancy headquartered in Hong Kong, and Co-Founder of Second Talent, a global tech hiring platform ranked #1 in Global Hiring on G2. With 12 years of experience in e-commerce strategy, platform implementation, and digital operations, he has led delivery of Adobe Commerce Cloud projects for enterprise clients including Chow Sang Sang, HomePlus (HKBN), Maxim's, Hong Kong International Airport, Hotai/Toyota, and Evisu. Prior to founding Branch8, Matt served as Vice President of Mid-Market Enterprises at HSBC. He serves as Vice Chairman of the Hong Kong E-Commerce Business Association (HKEBA). A self-taught software engineer, Matt graduated from the University of Toronto with a Bachelor of Commerce in Finance and Economics.