【Shopify最新ニュース2026・開発者向け】UI extensions の翻訳ファイル、合計256KBの上限を撤廃

2026年10月31日

開発者向けの変更です。

アプリの UI extensions で、多くの言語を出したい開発者に関わる話。

翻訳ファイルの合計256KBの上限がなくなりました

掲載は2026年10月30日、Shopify の developer changelog。

Flags は「Update」、Surfaces は「Platform」です。

出典: Shopify developer changelog「UI extensions now support a larger number of locales」2026年10月30日
https://shopify.dev/changelog/posts/ui-extensions-now-support-a-larger-number-of-locales

UI extensions no longer have a 256 KB limit on the combined size of their locale files. As of October 30, 2026, you can add more languages to an extension without hitting a combined size limit at deploy.
（UI extensions の翻訳ファイルの合計の大きさに、256 KB の上限はなくなりました。2026年10月30日から、デプロイで合計の大きさの上限に引っかからずに、拡張機能に言語を足せます）

これまでは、locales フォルダの中のファイルの合計が256KBまででした。
言語の多い拡張機能は、この上限でデプロイに失敗することがありました。
訳を削るか、言語を減らすしかなかった状態。

1ファイルあたり30KBの上限は残ります

外れたのは、合計の上限だけです。

That combined limit is now removed. The 30 KB limit for each individual locale file still applies.
（合計の上限はなくなりました。翻訳ファイル1つずつの 30 KB の上限は、これまでどおりです）

書式・ファイル名・フォールバックの動きも変わりません。

Locale files keep the same format, file naming, and fallback behavior described in the checkout UI extension localization guide. You don’t need to change how you structure translations.
（翻訳ファイルの書式・ファイル名・フォールバックの動きは、checkout UI extension の多言語化の手引きにあるとおりです。翻訳の組み立て方を変える必要はありません）

翻訳ファイルつきの UI extensions を持つアプリが、すべての API バージョンで対象です

対象は、翻訳ファイルを持つ UI extensions を含むアプリ全部。

This change applies to every app that includes UI extensions with locale files, on all API versions. Existing extension versions keep working as before. New deploys aren’t limited by the combined size of locale files.
（この変更は、翻訳ファイルを持つ UI extensions を含むすべてのアプリに、すべての API バージョンで当てはまります。今ある拡張機能のバージョンはこれまでどおり動きます。新しいデプロイは、翻訳ファイルの合計の大きさで止められません）

これまでの合計256KBの上限に収まっていた拡張機能は、何も変わりません。

対応は要りません

公式は「You don’t need to take any action」と書いています。

そのうえで、削った言語や訳を戻す手順を3つ挙げています。

拡張機能の locales フォルダに、要る翻訳ファイルを足す。例は de.json や pt-BR.json。1ファイルは30KB未満
shopify app deploy で、新しいアプリのバージョンを出す
開発ストアで、ストアか顧客のロケールを新しい言語にして、訳が出るかを見る

Run shopify app deploy to release a new app version.
（shopify app deploy を実行して、新しいアプリのバージョンを出します）

手引きが挙がっているのは checkout と customer account の2つです

原文の Related docs は2本。

Localize a checkout UI extension
Localize a customer account UI extension

ほかの面の UI extensions 向けの手引きは、原文の Related docs には挙がっていない形。

🔴 公式に書かれていないこと

次の点は、一次ソースにありません。

上限をなくした理由は書かれていません
翻訳ファイルの数に上限があるかは書かれていません
admin や POS など、checkout と customer account 以外の UI extensions での扱いの細目は書かれていません。本文は「every app that includes UI extensions」とだけ書いています
店の画面で使える言語が増えるかなど、店の側の影響は書かれていません
原文から張られている公式ドキュメントのリンクの先は、本記事では読んでいません
🔴 本記事はアプリをデプロイして確かめていません。記載が無いことをもって「できる」とも「できない」とも書きません