Store Locales

In this guide, you'll learn about locales defined in the Store Module.

Note: While the Store Module allows you to manage the locales for your store, the actual locale data and translations are managed by the Translation Module.

Supported Locales#

The Store Module has a StoreLocale data model that represents the locales supported by your store. It has a locale_code property that follows the IETF BCP 47 standard. For example, en-US represents American English, while fr-FR represents French (France).

StoreLocale belongs to the Store data model, which has a supported_locales property that lists all the locales available in your store.

For example, if your store supports English (United States) and French (France), you'll have two StoreLocale records with the locale codes en-US and fr-FR.

Diagram illustrating the relationship between the Store and StoreLocale data models

Was this page helpful?
Ask Bloom
For assistance in your development, use Claude Code Plugins or Medusa MCP server in Cursor, VSCode, etc...FAQ
What is Medusa?
How can I create a module?
How can I create a data model?
How do I create a workflow?
How can I extend a data model in the Product Module?
Recipes
How do I build a marketplace with Medusa?
How do I build digital products with Medusa?
How do I build subscription-based purchases with Medusa?
What other recipes are available in the Medusa documentation?
Chat is cleared on refresh
Line break