How to Translate UpCart Using Translation Lab
UpCart embeds its cart interface inside a shadow-root, which means that regular translation tools (including Translation Lab's default or custom methods) cannot directly access or modify its content.
However, UpCart has made key text resources translatable by defining them as Shop Metafields. These metafields are fully compatible with Translation Lab and can be edited to provide translations for your desired languages.
Steps to Translate UpCart with Translation Lab
Open Translation Lab.
Go to the “Translations” section in the left-hand menu.
Scroll down and click on “Shop Metafields.”
Look for metafields defined by UpCart. These typically include text like button labels, shipping messages, or other UI elements inside the cart, most commonly the Shop Metafield that needs to be translated is "upcartSettings.translations"
Once you find the Shop Metafield you would like to translate simply click on the button in the middle to AI Translate it, or manually translate it by replacing the text in between the code, ensuring that the code remains untouched.
This is it! Now save your changes, and you should see the translations done in the cart of your store.
⚠️ Important Notes
Only the fields that UpCart has made translatable can be edited. If something appears untranslated and you can’t find it under Shop Metafields, it likely hasn’t been exposed by UpCart.
When making manual translations, be careful to edit only the text content and do not modify any surrounding code or formatting tags. This helps maintain the integrity of the metafield structure and ensures your translations display correctly in the cart.