Manage Translations in Medusa Admin

In this guide, you’ll learn how to manage translations of resources like products in the Medusa Admin.

Note: Translations are available from Medusa v2.12.3. If you don't see the locale settings in your Medusa Admin, request your technical team to upgrade your Medusa application.

Translations Overview#

Medusa allows you to translate various resources in your store, such as product titles and descriptions, into multiple locales (languages) supported by your store.

Tip: You can set supported locales for your store in the Store settings page.

Then, in the storefront, customers can view content in their preferred language based on the available locales.

You can view and manage translations in the Medusa Admin dashboard by going to Settings → Translations. This page allows you to manage translations of resources in bulk.

Alternatively, you can manage translations for individual resources directly from their respective pages (for example, from a product's detail page).

Translations settings page


Manage Translations in Bulk#

In the Translations settings page, you can view and manage translations in bulk for various resources in your store, including products and variants.

Note: Currently, Medusa supports translations for product-related resources only. Future versions will include support for translating more core resources, as well as custom resources.

For example, to manage product translations in bulk:

  1. Go to Settings → Translations.
  2. Click on the Edit button in the "Products" row.
  3. This will open a bulk editor where you can view and edit translations for product titles, descriptions, subtitles, and more in each locale supported in your store.
    • You can switch between locales using the Locales dropdown at the top of the bulk editor.
    • You can click the "Save Changes" button at any time to save your progress without closing the bulk editor.
  4. Once you're done editing, click the "Save and close" button to apply the changes.

Customers will then see the translated content in the storefront based on their selected locale.


View Translation Statistics#

Each resource row in the Translations settings page displays how many fields have been translated out of the total translatable fields for that resource.

The "Translated fields" section also shows a general progress bar of how many fields have been translated across all resources and locales in your store. You can use this summary to track your overall translation progress.

Translation statistics in Translated fields section

There are two charts in this section:

  1. A progress bar showing the overall translation progress across all resources and locales.
  2. A bar chart showing the number of translated fields per locale.

These charts help you visualize your translation efforts and identify which locales may need more attention.

Was this guide helpful?
Ask Anything
Ask any questions about Medusa. Get help with your development.
You can also use the 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