|
1 | 1 | --- |
2 | 2 | title: 'Currency' |
3 | | -description: 'This article explains how to create & work with a Currency field.' |
| 3 | +description: 'This article explains how to create and use a Currency field.' |
4 | 4 | tags: ['Fields', 'Field types', 'Numerical types', 'Currency'] |
5 | 5 | keywords: ['Fields', 'Field types', 'Numerical types', 'Currency', 'Create currency field'] |
6 | 6 | --- |
7 | 7 |
|
| 8 | +The **Currency** field is a numerical field used to store monetary values. It provides additional options to configure the currency locale and symbol for display. |
8 | 9 |
|
9 | | -`Currency` field type is used to store currency values. It is a numerical field with additional provision to set the currency symbol in display. |
| 10 | +<Callout type="warning">Currency formatting is applied only for display. The stored value remains numerical for calculations and formulas.</Callout> |
10 | 11 |
|
11 | | -## Create field |
12 | | -1. Click on `+` icon to the right of `Fields header` |
13 | | -2. On the dropdown modal, enter the field name (Optional). |
14 | | -3. Select the field type as `Currency` from the dropdown. |
15 | | -4. Configure `Currency Locale` : defaults to `en-US` |
16 | | -5. Configure `Currency Symbol` : defaults to `$` |
17 | | -6. Set default value for the field (Optional). |
18 | | -7. Click on `Save Field` button. |
| 12 | +## Create a Currency field |
19 | 13 |
|
20 | | - |
| 14 | +1. Click the `+` icon next to the last field in your table. |
| 15 | +2. Enter a name for the field. |
| 16 | +3. Select **Currency** from the list of field types. |
| 17 | +4. Configure **Currency Locale** (defaults to `en-US`). |
| 18 | +5. Configure **Currency Symbol** (defaults to `$`). |
| 19 | +6. (Optional) Set a default value for the field and add a description. |
| 20 | +7. Click **Save field** to add the field to your table. |
21 | 21 |
|
22 | | -### Cell display |
23 | | - |
| 22 | +Refer to the general guidelines on [creating a field](/docs/product-docs/fields#create-a-field). |
24 | 23 |
|
25 | | -### Supported locales |
26 | | -https://www.npmjs.com/package/locale-codes#locale-list |
27 | 24 |
|
28 | | -<Callout type="note"> |
29 | | -NocoDB adheres to ISO639-1 standard for locale codes. |
30 | | -</Callout> |
| 25 | +## Cell display |
31 | 26 |
|
32 | | -### Supported currencies |
| 27 | +The **Currency** field appears as a numeric cell with the configured currency symbol and formatting. |
| 28 | + |
| 29 | + |
| 30 | + |
| 31 | +## Supported locales |
| 32 | + |
| 33 | +NocoDB supports locale codes based on the [ISO639-1 standard](https://www.npmjs.com/package/locale-codes#locale-list). |
| 34 | + |
| 35 | +<Callout type="info">Ensure the correct locale is selected to apply region-specific number formatting (e.g., **en-US**, **fr-FR**).</Callout> |
| 36 | + |
| 37 | +## Supported currencies |
| 38 | + |
| 39 | +The **Currency** field supports a wide range of ISO 4217 currency codes, including but not limited to: |
33 | 40 |
|
34 | 41 | | | | | | | | |
35 | 42 | |-----|-----|-----|-----|-----|-----| |
@@ -65,10 +72,4 @@ NocoDB adheres to ISO639-1 standard for locale codes. |
65 | 72 | | XPD | XPF | XPT | XTS | XXX | YER | |
66 | 73 | | ZAR | ZMK | ZWD | | | | |
67 | 74 |
|
68 | | - |
69 | | - |
70 | | -## Similar numerical fields |
71 | | -Following are the other numerical fields available in NocoDB, with some custom add-on features. |
72 | | -- [Number](/docs/product-docs/fields/field-types/numerical/number) |
73 | | -- [Decimal](/docs/product-docs/fields/field-types/numerical/decimal) |
74 | | -- [Percent](/docs/product-docs/fields/field-types/numerical/percent) |
| 75 | +--- |
0 commit comments