Files
Shahed Nasser c1a5390fc6 docs: translation module (#14271)
* docs: translation module

* fix link in JS SDK

* add translations user guides [WIP]

* updates

* fix broken link

* remove mentions of default locale

* change header

* updates

* updated user guides

* handle todos

* fix build error

* fix lint errors
2025-12-17 13:07:43 +02:00

142 lines
5.9 KiB
Plaintext
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
sidebar_position: 2
sidebar_label: "Manage Store"
tags:
- user guide
- store
- currency
- name: translation
label: Manage Store Locales
products:
- currency
- translation
- store
---
import { EllipsisHorizontal, ArrowUpRightOnBox, EllipsisVertical } from "@medusajs/icons"
export const metadata = {
title: `Manage Store in Medusa Admin`,
}
# {metadata.title}
In this guide, youll learn how to edit the stores details and available currencies.
## View Store Details
To view your store's details, go to Settings → Store. There, you can view and manage the store's details and its available currencies.
![Store Details](https://res.cloudinary.com/dza7lstvk/image/upload/v1739962494/User%20Guide/Screenshot_2025-02-19_at_12.54.00_PM_eozum8.png)
---
## Edit Store Details
To edit the stores details:
1. Go to Settings → Store.
2. Click the <InlineIcon Icon={EllipsisHorizontal} alt="three-dots" /> icon in the "Store" section's header.
3. Choose Edit from the dropdown.
4. In the side window that opens, you can edit the store's name, default currency, default region, default sales channel, and default location. These defaults are used in the storefront if no other values are provided.
5. Once you're done, click the Save button.
![Edit store form](https://res.cloudinary.com/dza7lstvk/image/upload/v1739962919/User%20Guide/Screenshot_2025-02-19_at_1.01.47_PM_l2zhnc.png)
---
## Manage Currencies
Your store can support multiple currencies, allowing customers to view prices in their preferred currency. You can add or remove currencies in the store settings.
### Add Currencies
To add currencies to your store:
1. Go to Settings → Store.
2. Click the <InlineIcon Icon={EllipsisHorizontal} alt="three-dots" /> icon in the "Currencies" section's header.
3. Choose Add from the dropdown.
4. In the list that opens, check the currencies you want to add to the store.
- To enable [tax-inclusive pricing](#edit-tax-inclusive-setting-for-currency) for a currency, enable the toggle next to the currency.
5. Once you're done, click the Save button.
![Add currencies to store](https://res.cloudinary.com/dza7lstvk/image/upload/v1739963867/User%20Guide/Screenshot_2025-02-19_at_1.17.37_PM_mjrxng.png)
### Edit Tax-Inclusive Setting for Currency
In the store's settings, you can also manage a currency's tax-inclusive price setting. During checkout, after Medusa calculates the tax of a product or shipping, it will either:
- Add the tax to the product's price (tax-exclusive pricing).
- Include the tax in the product's price (tax-inclusive pricing).
You can manage whether a currency uses tax-inclusive pricing when adding or editing it. To edit the tax-inclusive setting for a currency:
1. Go to Settings → Store.
2. Click the <InlineIcon Icon={EllipsisHorizontal} alt="three-dots" /> icon next to the currency you want to edit.
3. Choose "Enable tax-inclusive pricing" or "Disable tax-inclusive pricing" from the dropdown, depending on the current setting.
### Remove Currencies
You can remove any currency from your store that isn't the default currency. You can add the currency again later if needed.
To remove a currency:
1. Go to Settings → Store.
2. Under the Currencies section, check the checkbox next to the currencies you want to remove.
3. Press <Kbd>R</Kbd> or click the Remove button at the bottom center of the page.
4. Confirm removing the currencies by clicking the Remove button in the pop-up.
![Remove currencies from store](https://res.cloudinary.com/dza7lstvk/image/upload/v1739963798/User%20Guide/Screenshot_2025-02-19_at_1.16.17_PM_hlzti3.png)
---
## Manage Store Locales
<Note>
Locales are available from [Medusa v2.12.3](https://github.com/medusajs/medusa/releases/tag/v2.12.3). If you don't see the locale settings in your Medusa Admin, request your technical team to [upgrade your Medusa application](!docs!/learn/update).
</Note>
Locales define the languages that your store supports for displaying content to customers. You can manage the store's available locales in the store settings. Then, you can translate content like product titles and descriptions into these locales from the [Translations](../translations/page.mdx) settings.
## Add Locales to Store
To add supported locales to your store:
1. Go to Settings → Store.
2. Click the <InlineIcon Icon={EllipsisHorizontal} alt="three-dots" /> icon in the "Locales" section's header.
3. Choose Add from the dropdown.
4. In the list that opens, check the locales you want to add to the store.
5. Once you're done, click the Save button.
You can now add translations for resources in the added locales on the [Translations](../translations/page.mdx) settings.
### Remove Locales from Store
To remove a locale from your store:
1. Go to Settings → Store.
2. Under the Locales section, check the checkbox next to the locales you want to remove.
3. Press <Kbd>R</Kbd> or click the Remove button at the bottom center of the page.
4. Confirm removing the locales by clicking the Remove button in the pop-up.
---
## Manage Store Metadata
Metadata is custom data that can be associated with the store in key-value pairs. This is usually used by developers for custom integrations or to store additional information about the store.
To edit the store's metadata:
1. Click the <InlineIcon Icon={ArrowUpRightOnBox} alt="arrow" /> icon in the "Metadata" section.
2. In the side window that opens:
- Manage the key-value pairs in the table.
- To add a new row of key-value pairs before or after a row:
- Hover over the row and click the <InlineIcon Icon={EllipsisVertical} alt="three-dots" /> icon at its end.
- Choose "Insert row above" or "Insert row below" from the dropdown.
- To delete a row of key-value pairs:
- Hover over the row and click the <InlineIcon Icon={EllipsisVertical} alt="three-dots" /> icon at its end.
- Choose "Delete row" from the dropdown.
3. Once you're done, click the Save button.