> ## Documentation Index
> Fetch the complete documentation index at: https://docs.metrifox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Localization

## **Overview**

Price localization lets you display and charge different currencies and prices based on a customer's location. This improves conversion rates, supports regional pricing strategies, and helps with compliance (e.g., local currencies or tax display rules).

When enabled on a plan, Metrifox automatically shows the localized price in pricing tables and checkout based on the customer's billing country (detected from address or IP).

Localization is configured per plan. Localized prices override the plan's default currency/pricing for selected countries.

### **Enabling Price Localization**

Localization is disabled by default.

1. Open a plan (**Catalog → Products → \[Product] → Plans → \[Plan]**).
2. In the **Plan details** section, toggle **Price localization** on.

Once enabled, a **+ Add localized price** button appears.

<img src="https://mintcdn.com/metrifox/QY1tpwSNCthU90js/images/localization/enable_localization.png?fit=max&auto=format&n=QY1tpwSNCthU90js&q=85&s=beb615385d33d87358a75bb09f172cd1" alt="Enable Localization" title="Enable Localization" style={{ width:"52%" }} width="538" height="1158" data-path="images/localization/enable_localization.png" />

### **Adding a Localized Price**

1. Click **+ Add localized price**.
2. In the first modal:
   * Select a **Country** from the dropdown.
   * Select the **Currency** for that country.

     <img src="https://mintcdn.com/metrifox/QY1tpwSNCthU90js/images/localization/add_price.png?fit=max&auto=format&n=QY1tpwSNCthU90js&q=85&s=12a4bb39e297783976283a3d173117ec" alt="Add Price" style={{ width:"99%" }} width="1490" height="1570" data-path="images/localization/add_price.png" />
3. A second modal opens to define pricing for this localization (similar to regular plan pricing):
   * Define prices/tiers (Pricing type: Graduated/Volume, model: Per unit/Package/Flat/Percentage).
   * (Optional) Add tax, min/max, flat fees.
   * Enter the localized prices for the default billing intervals
   * Click **Save price** after setting up localized price for each offering
   * Click **Done** after saving all prices, you can also click it if you would like to come back to pricing later .

     <img src="https://mintcdn.com/metrifox/QY1tpwSNCthU90js/images/localization/save_localized_prices.png?fit=max&auto=format&n=QY1tpwSNCthU90js&q=85&s=ca40dba7056d43f64b0dbb8dde1e2e5c" alt="Save Localized Prices" width="1486" height="1566" data-path="images/localization/save_localized_prices.png" />

You can add multiple localizations (one per country/currency pair).

### **Managing Localizations**

Localizations appear in a dedicated tab or section (alongside All, Prices, Features, etc.).

* **Filters**: Use the currency/country icons + dropdown to filter the view (e.g., show only USD or EU countries).

  <img src="https://mintcdn.com/metrifox/3QofMz8igo5-BxJf/images/localization/filter.png?fit=max&auto=format&n=3QofMz8igo5-BxJf&q=85&s=18f6e9f498bd149b573459936d26e58a" alt="Filter" width="1680" height="440" data-path="images/localization/filter.png" />
* **Incomplete setups**:

  If a localization lacks prices, warnings appear:

  * Individual: "Complete this localized price setup to make it available on checkout. Continue pricing."

    <Note>
      You've created 6 localization(s). Missing price(s): 2
    </Note>
  * Summary: "You've created X localizations. Y don't have price(s) yet. Resolve now."

    <Note>
      **You've created 6 localizations. 1 of them don't have price(s) yet.**
    </Note>
* Click **Resolve now** or **Continue pricing** to open the modal for unfinished localizations (complete pricing or delete via trash icon).

  <img src="https://mintcdn.com/metrifox/QY1tpwSNCthU90js/images/localization/complete_localization.png?fit=max&auto=format&n=QY1tpwSNCthU90js&q=85&s=9bd48707b3563189a6ee0e8e1be5a4c6" alt="Complete Localization" width="1484" height="1564" data-path="images/localization/complete_localization.png" />
* Add more via **+ Add localized price**.

**Important Notes**

* Localizations can be created and configured on draft or launched plans but can only be activated on **launched** plans.
* Default (non-localized) prices apply as fallback for unsupported countries.
* Changes to localization after plan is launched creates a new plan version (existing customers unaffected).
* For advanced regional tax or compliance, combine with global **Taxes** [(see Taxes docs).](https://docs.metrifox.com/tax)
