---
title: >-
  UI extensions now support a larger number of locales - Shopify developer
  changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/posts/ui-extensions-now-support-a-larger-number-of-locales
  md: >-
    https://shopify.dev/changelog/posts/ui-extensions-now-support-a-larger-number-of-locales.md
metadata:
  effectiveApiVersion: ''
  affectedApi: []
  primaryTag:
    displayName: Platform
    handle: platform
  secondaryTag:
    displayName: Update
    handle: update
  indicatesActionRequired: false
  createdAt: '2026-10-30T13:37:37-04:00'
  postedAt: '2026-10-30T14:00:00-04:00'
  updatedAt: '2026-10-30T14:15:21-04:00'
  effectiveAt: '2026-10-31T12:00:00-04:00'
---

October 30, 2026

# UI extensions now support a larger number of locales

DateOctober 30, 2026

FlagsUpdate

SurfacesPlatform

UI extensions no longer have a 256 KB limit on the combined size of their [locale files](https://shopify.dev/docs/apps/build/checkout/localized-checkout-ui-extensions#locale-files). As of October 30, 2026, you can add more languages to an extension without hitting a combined size limit at deploy. This applies to all apps with UI extensions, and no action is required.

## What changed

Previously, the total size of the locale files in a UI extension's `locales` folder couldn't exceed 256 KB. Extensions with many languages could reach that limit and fail to deploy, which forced you to trim translations or drop languages.

That combined limit is now removed. The 30 KB limit for each individual locale file still applies. Locale files keep the same format, file naming, and fallback behavior described in the [checkout UI extension localization guide](https://shopify.dev/docs/apps/build/checkout/localized-checkout-ui-extensions/localize). You don't need to change how you structure translations.

## Who's affected

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.

If your extensions were under the old limit, nothing changes for you.

## What to do

You don't need to take any action. If you previously removed languages or shortened translations to stay under 256 KB, you can add them back:

1. Add the locale files you need to your extension's `locales` folder, for example `de.json` or `pt-BR.json`. Keep each file under 30 KB.
2. Run `shopify app deploy` to release a new app version.
3. Preview the extension in a development store with the store or customer locale set to one of the new languages, and confirm the translated strings appear.

## Related docs

* [Localize a checkout UI extension](https://shopify.dev/docs/apps/build/checkout/localized-checkout-ui-extensions/localize)
* [Localize a customer account UI extension](https://shopify.dev/docs/apps/build/customer-accounts/localization/localize)