# Source: https://getlago.com/docs/api-reference/resources/locales.md

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

# Document locales

## Document locales supported

List of accepted locales for documents (ISO 639-1).

| Document language   | Code    |
| ------------------- | ------- |
| German              | `de`    |
| English             | `en`    |
| French              | `fr`    |
| Italian             | `it`    |
| Norwegian (Bokmål)  | `nb`    |
| Portuguese (Brazil) | `pt-BR` |
| Spanish             | `es`    |
| Swedish             | `sv`    |

## How to add a new language

You can contribute to Lago's open-source project by helping us translate documents. The new language will then be added to the list of supported locales and available to the entire Lago Community.

The document template includes translation keys for:

* Invoices related to subscriptions, add-ons and prepaid credits;
* Credit notes;
* Data formatting (e.g. amounts and dates); and
* Syntax (i.e. sentence structure).

<Info>
  The names of your billable metrics, plans, add-ons, coupons and wallets are defined in the app. There are no keys to translate them.
</Info>

To add a new language:

1. [Download the document template](http://d376nw0erossg9.cloudfront.net/doc-locales-template-copies.pdf) to see where each key is located;
2. Use the text file below to provide translations for the new language; and
3. Send the new text file to [hello@getlago.com](mailto:hello@getlago.com), so that we can review it and add it to the codebase.

Thanks for your time and support!

```json  theme={"dark"}
en:
  money:
    //[AA] format: $4,500.00
    format: '%u%n'
    decimal_mark: '.'
    thousands_separator: ','
  date:
    formats:
      //[AB] format: Dec. 01, 2022
      default: '%b. %d, %Y'
    abbr_day_names:
      - Sun
      - Mon
      - Tue
      - Wed
      - Thu
      - Fri
      - Sat
    abbr_month_names:
      - Jan
      - Feb
      - Mar
      - Apr
      - May
      - Jun
      - Jul
      - Aug
      - Sep
      - Oct
      - Nov
      - Dec
    day_names:
      - Sunday
      - Monday
      - Tuesday
      - Wednesday
      - Thursday
      - Friday
      - Saturday
    month_names:
      - January
      - February
      - March
      - April
      - May
      - June
      - July
      - August
      - September
      - October
      - November
      - December
    order:
      - :year
      - :month
      - :day


=====================================================================


en:
  invoice:
    [1.1] document_name: "Invoice"
    [1.2] invoice_number: "Invoice number"
    [1.3] issue_date: "Issue date"
    [1.4] payment_term: "Payment term"
    [1.5] payment_term_days: "%{net_payment_term} days"
    [1.6] bill_from: "From"
    [1.7] bill_to: "Bill to"
    [1.8] tax_identification_number: "Tax ID: %{tax_identification_number}"
    [1.9] due_date: "Due %{date}"
    [1.10] item: "Item"
    [1.11] unit: "Unit"
    [1.12] unit_price: "Unit price"
    [1.13] tax_rate: "Tax rate"
    [1.14] amount: "Amount (excl. tax)"
    [1.15] sub_total_without_tax: "Sub total (excl. tax)"
    [1.16] tax_name: "%{name} (%{rate}% on %{amount})"
    [1.17] sub_total_with_tax: "Sub total (incl. tax)"
    [1.18] credit_notes: "Credit notes"
    [1.19] prepaid_credits: "Prepaid credits"
    [1.20] total_due: "Total due"
    [1.21] powered_by: "Powered by"

    [AA] total_amount: "Total amount"

    [AC] details: "%{resource} details"
    [2.1] date_from: "Fees from"
    [2.2] date_to: "to"
    [AD] subscription_interval: "%{plan_interval} subscription fee - %{plan_name}"
    [2.3] weekly: "Weekly"
    [2.4] monthly: "Monthly"
    [2.5] quarterly: "Quarterly"
    [2.6] yearly: "Yearly"

    graduated & graduated percentage:
      [2.7] fee_per_unit_for_the_first: "Fee per unit for the first %{to}"
      [2.8] fee_per_unit_for_the_next: "Fee per unit for the next %{from} to %{to}"
      [2.9] fee_per_unit_for_the_last: "Fee per unit for %{from} and above"
      [2.10] flat_fee_for_the_first: "Flat fee for first %{to}"
      [2.11] flat_fee_for_the_next: "Flat fee for next %{from} to %{to}"
      [2.12] flat_fee_for_the_last: "Flat fee for %{from} and above"
      [2.13] sub_total: "Subtotal"

    [2.14] fee_prorated: "The fee is prorated on days of usage, the displayed unit price is an average"

    package:
      [2.15] free_units_for_the_first: "Fee per unit for the first %{count}"
      [2.16] fee_per_package: "Fee per package"
      [2.17] fee_per_package_unit_price: "%{amount} per %{package_size}"

    percentage:
      [2.18] total_event: "Total events: %{total_events} transactions"
      [2.19] free_units_per_transaction:
        one: "Free units for 1 transaction"
        other: "Free units for %{count} transactions"
      [2.20] percentage_rate_on_amount: "Fee on the amount"
      [2.21] fee_per_transaction: "Fee per transaction"
      [2.22] adjustment_per_transaction: "Adjustment for min/ max per transaction"

    [2.23] true_up_metric: "%{metric} • True up"
    [2.24] true_up_details: "Minimum spend of %{min_amount} prorated on days of usage"

    volume:
      [2.25] fee_per_unit: "Fee per unit"
      [2.26] flat_fee_for_all_units: "Flat fee for all units"

    [2.27] units_prorated_per_period: "Units prorated per second per %{period}"
    [2.28] week: "week"
    [2.29] month: "month"
    [2.30] quarter: "quarter"
    [2.31] year: "year"
    [2.32] total: "Total"

    [3.1] breakdown: "Breakdown"
    [3.2] breakdown_of: "Breakdown of %{fee_filter_display_name}"
    [3.3] breakdown_for_days: "Used %{breakdown_duration} out of %{breakdown_total_duration} days"
    [3.4] notice_prorated: "Regardless of when an event is received, the unit is not prorated, we charge the full price."
    [3.5] notice_full: "If a unit is added or removed during the monthly plan, we calculate the prorated price based on the ratio of days remaining or used to the total number of days in the plan. For instance, if 15 days are left in the plan, we multiply the price by 15/31, and if a unit was used for 10 days, we multiply the price by 10/31."

    [4.1] prepaid_credits_with_value: "Prepaid credits - %{wallet_name}"

    //For invoices with old versions
    total_credits_with_value: "Total credits amount: %{credit_amount} credits"
    all_subscriptions: "All subscriptions"
    all_usage_based_fees: "All consumption fees"
    tax: "Taxes"
    fees_from_to_date: "Consumption fees from %{from_date} to %{to_date}"
    tax_name_with_details: "%{name} (%{rate}%)"
    subscription: "Subscription"
    sub_total: "Subtotal"
    usage_based_fees: "Consumption fees"
    list_of_charges: "List of consumption fees from %{from} to %{to}"
    see_breakdown: "See breakdown below"
    total_unit_interval: "Total number of units: %{events_count} event(s) for %{units}"
    total_unit: "Total number of units: %{units}"
    amount_with_tax: "Amount (incl. tax)"
    amount_without_tax: "Amount (excl. tax)"


=====================================================================


en:
  credit_note:
    [5.1] document_name: "Credit note"
    [5.2] credit_note_number: "Credit note number"
    [5.3] invoice_number: "Invoice number"
    [5.4] issue_date: "Issue date"
    [5.5] credit_from: "From"
    [5.6] credit_to: "Bill to"
    [5.7] tax_identification_number: "Tax ID: %{tax_identification_number}"
    [5.8] refunded_notice: "Refunded on %{issuing_date}"
    [5.9] credited_notice: "Credited on customer balance on %{issuing_date}"
    [5.10] credited_refunded_notice: "Credited on customer balance and refunded on %{issuing_date}"
    [5.11] item: "Item"
    [5.12] tax_rate: "Tax rate"
    [5.13] amount: "Amount (excl. tax)"
    [5.14] subscription: "Subscription - %{plan_name}"
    [5.15] true_up_metric: "%{metric} • True up"
    [5.16] coupon_adjustment: "Coupons"
    [5.17] sub_total_without_tax: "Sub total (excl. tax)"
    [5.18] tax: "Sales tax (%{rate}% on %{amount})"
    [5.19] credited_on_customer_balance: "Credited on customer balance"
    [5.20] refunded: "Refunded"
    [5.21] total: "Total"
    [5.22] powered_by: "Powered by"


=====================================================================


en:
  email:
    invoice:
      finalized:
        [6.1] subject: "Your invoice from %{organization_name} #%{invoice_number}"
        [6.2] invoice_from: "Invoice from %{organization_name}"
        [6.3] due_date: "Due %{date}"
        [6.4] invoice_number: "Invoice number"
        [6.5] issue_date: "Issue date"
        [6.6] download: "Download invoice for details"
    credit_note:
      created:
        [6.7] subject: "Your credit note from from %{organization_name} #%{credit_note_number}"
        [6.8] credit_note_from: "Credit note from from %{organization_name}"
        [6.9] refunded_notice: "Refunded on %{date}"
        [6.10] credited_notice: "Credited on customer balance on %{date}"
        [6.11] credited_refunded_notice: "Credited on customer balance and refunded on %{date}"
        [6.12] credit_note_number: "Credit note number"
        [6.13] invoice_number: "Invoice number"
        [6.14] issue_date: "Issue date"
        [6.15] download: "Download credit note for details"
    [6.98] questions: "Questions? Contact us at"
    [6.99] powered_by_lago: "Powered by"


=====================================================================


en:
  customer_portal:
    [7.1] page_title: "Manage your plans & billing"
    [7.2] wallet: "Wallet"
    [7.3] wallet_name_balance: "%{wallet_name} - Balance"
    [7.4] wallet_credits_count: "%{credits_count} credit"
    [7.5] wallet_credits_used: "Total credits used"
    [7.6] top_up_wallet: "Top up wallet"
    [7.7] wallet_expiry_date: "Expiry date"
    [7.8] plans: "Plans"
    [7.9] plan_name: "%{plan_name}"
    [7.10] plan_price: "%{amount} (excl. tax) per %{interval}"
    [7.11] plan_renews_on: "Your plan renews on %{date}"
    [7.12] view_usage: "View usage"
    [7.13] customer_information: "Customer information"
    [7.14] edit_information: "Edit information"
    [7.15] name: "Name"
    [7.16] billing_email: "Billing email"
    [7.17] legal_name: "Legal name"
    [7.18] billing_address: "Billing address"
    [7.19] legal_number: "Legal number"
    [7.20] shipping_address: "Shipping address"
    [7.21] address_not_provided: "Address not provided"
    [7.22] invoice_history: "Invoice history"
    [7.23] total_invoiced: "Total invoiced"
    [7.24] total_overdue: "Total overdue"
    [7.25] invoices_search: "Search"
    [7.26] issuing_date: "Issuing date"
    [7.27] invoice_type: "Type"
    [7.28] invoice_number: "Invoice number"
    [7.29] amount: "Amount"
    [7.30] payment: "Payment"
    [7.31] credits: "Credits"
    [7.32] one_off_invoice: "One off invoice"
    [7.33] advance_charges: "Advance charges"
    [7.34] overdue: "Overdue"
    [7.35] progressive_billing: "Progressive billing"
    [7.36] subscription: "Subscription"
    [7.37] unpaid: "Unpaid"
    [7.38] load_more: "Load more"

    edit_customer:
      [8.1] page_title: "Edit Customer Information"
      [8.2] general_information: "General information"
      [8.3] customer_type: "Customer type"
      [8.4] customer_type_placeholder: "Search or select a customer type"
      [8.5] customer_name: "Customer name"
      [8.6] customer_name_placeholder: "Type a customer name"
      [8.7] first_name: "First name"
      [8.8] last_name: "Last name"
      [8.9] first_name_placeholder: "Type a first name"
      [8.10] last_name_placeholder: "Type a last name"
      [8.11] legal_name: "Legal name"
      [8.12] legal_name_placeholder: "Type a legal name"
      [8.13] tax_identification_number: "Tax identification number"
      [8.14] tax_identification_number_placeholder: "Type a tax identification number"
      [8.15] email: "Email"
      [8.16] email_placeholder: "Type an email"
      [8.17] billing_address: "Billing address"
      [8.18] address: "Address"
      [8.19] address_line_1: "Address line 1"
      [8.20] address_line_2: "Address line 2"
      [8.21] zip_code: "Zip code"
      [8.22] city: "City"
      [8.23] state: "State"
      [8.24] country: "Country"
      [8.25] shipping_address: "Shipping address (optional)"
      [8.26] use_billing_address: "Use the same information from the billing address"
      [8.27] shipping_address_label: "Address"
      [8.28] shipping_address_line_1: "Address line 1"
      [8.29] shipping_address_line_2: "Address line 2"
      [8.30] shipping_zip_code: "Zip code"
      [8.31] shipping_city: "City"
      [8.32] shipping_state: "State"
      [8.33] shipping_country: "Country"
      [8.34] save_information: "Save information"

    usage:
      [9.1] page_title: "Usage"
      [9.2] plan: "Plan"
      [9.3] plan_price: "%{amount} (excl. tax) per %{interval}"
      [9.4] plan_renews_on: "Your plan renews on %{date}"
      [9.5] lifetime_usage: "Lifetime usage"
      [9.6] lifetime_usage_period: "From %{from_date} to %{to_date}"
      [9.7] total_lifetime_usage: "Total lifetime usage"
      [9.8] last_threshold: "Last threshold: %{amount}"
      [9.9] next_threshold: "Next threshold not set"

    current_usage:
      [10.1] page_title: "Usage"
      [10.2] usage_period: "From %{from_date} to %{to_date}"
      [10.3] current_usage_tab: "Current usage"
      [10.4] projected_usage_tab: "Projected usage"
      [10.5] total_current_usage: "Total current usage (excl. tax)"
      [10.6] charge_name: "Charge name"
      [10.7] current_units: "Current units"
      [10.8] current_amount: "Current amount"

    projected_usage:
      [11.1] total_projected_usage: "Total projected usage (excl. tax)"
      [11.2] projected_units: "Projected units"
      [11.3] projected_amount: "Projected amount"

    top_up_wallet:
      [12.1] page_title: "Top-Up Wallet"
      [12.2] credits_to_purchase: "Credits to purchase"
      [12.3] credits_unit: "credits"
      [12.4] purchase_amount: "You will purchase %{amount}"
      [12.5] top_up_credits: "Top up credits"

    misc:
      [13.1] total_overdue_tooltip: "Total from past due invoices. This is the amount you owe."
      [13.2] company: "Company"
      [13.3] individual: "Individual"
      [13.4] download_pdf: "Download PDF"
```