Skip to content

Commit f7919f0

Browse files
committed
docs: other numeric fields
Signed-off-by: Raju Udava <86527202+dstala@users.noreply.github.com>
1 parent 2f61025 commit f7919f0

File tree

9 files changed

+73
-59
lines changed

9 files changed

+73
-59
lines changed

content/docs/fields/field-types/numerical/currency.mdx

Lines changed: 27 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -1,35 +1,42 @@
11
---
22
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.'
44
tags: ['Fields', 'Field types', 'Numerical types', 'Currency']
55
keywords: ['Fields', 'Field types', 'Numerical types', 'Currency', 'Create currency field']
66
---
77

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.
89

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>
1011

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
1913

20-
![image](/img/v2/fields/types/currency.png)
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.
2121

22-
### Cell display
23-
![image](/img/v2/fields/currency-cell-display.png)
22+
Refer to the general guidelines on [creating a field](/docs/product-docs/fields#create-a-field).
2423

25-
### Supported locales
26-
https://www.npmjs.com/package/locale-codes#locale-list
2724

28-
<Callout type="note">
29-
NocoDB adheres to ISO639-1 standard for locale codes.
30-
</Callout>
25+
## Cell display
3126

32-
### Supported currencies
27+
The **Currency** field appears as a numeric cell with the configured currency symbol and formatting.
28+
29+
![Cell display](/img/v2/fields/types/numerical/currency-display.png)
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:
3340

3441
| | | | | | |
3542
|-----|-----|-----|-----|-----|-----|
@@ -65,10 +72,4 @@ NocoDB adheres to ISO639-1 standard for locale codes.
6572
| XPD | XPF | XPT | XTS | XXX | YER |
6673
| ZAR | ZMK | ZWD | | | |
6774

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+
---

content/docs/fields/field-types/numerical/decimal.mdx

Lines changed: 23 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,29 +1,34 @@
11
---
22
title: 'Decimal'
3-
description: 'This article explains how to create & work with a Decimal field.'
3+
description: 'This article explains how to create and use a Decimal field.'
44
tags: ['Fields', 'Field types', 'Numerical types', 'Decimal']
55
keywords: ['Fields', 'Field types', 'Numerical types', 'Decimal', 'Create decimal field']
66
---
77

8+
The **Decimal** field is a numerical field used to store decimal values. It is commonly used for data such as salary, price, or other values requiring fractional precision.
89

9-
`Decimal` field type is used to store decimal values. Use cases include storing `salary`, `price`, etc. NocoDB supports precision of upto 8 digits.
10+
<Callout type="warning">NocoDB supports up to 8 digits of precision.</Callout>
1011

11-
## Create a decimal 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 `Decimal` from the dropdown.
15-
4. Configure `Precision`- NocoDB supports upto 8 digits of precision.
16-
5. Set default value for the field (Optional).
17-
6. Click on `Save Field` button.
12+
## Create a Decimal field
1813

19-
![image](/img/v2/fields/types/decimal.png)
14+
1. Click the `+` icon next to the last field in your table.
15+
2. Enter a name for the field.
16+
3. Select **Decimal** from the list of field types.
17+
4. Configure the **Precision** setting (up to 8 digits).
18+
5. Toggle **Show thousands separator** to format large numbers with a thousand separator (e.g., 1,000.00 instead of 1000.00).
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.
2021

21-
<Callout type="note">
22-
Default decimal precision is 1 digit
23-
</Callout>
22+
Refer to the general guidelines on [creating a field](/docs/product-docs/fields#create-a-field).
23+
24+
25+
<Callout type="info">The default precision is set to 1 digit.</Callout>
26+
27+
## Cell display
28+
29+
The **Decimal** field appears as a numeric cell in the table, right-aligned for readability. Values are displayed with the configured number of decimal places. If the **Show thousands separator** option is enabled, large numbers will be formatted with a comma as the thousand separator.
30+
31+
![Number field cell display](/img/v2/fields/types/numerical/decimal-display.png)
32+
33+
---
2434

25-
## Similar numerical fields
26-
Following are the other numerical fields available in NocoDB, with some custom add-on features.
27-
- [Number](/docs/product-docs/fields/field-types/numerical/number)
28-
- [Percent](/docs/product-docs/fields/field-types/numerical/percent)
29-
- [Currency](/docs/product-docs/fields/field-types/numerical/currency)

content/docs/fields/field-types/numerical/number.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,6 @@ Refer to the general guidelines on [creating a field](/docs/product-docs/fields#
2626

2727
The **Number** field appears as a numeric cell in the table. Its display aligns to the right by default for clarity and consistency when handling numerical data. If the **Show thousands separator** option is enabled, large numbers will be formatted with a comma as the thousand separator.
2828

29-
![Number field cell display](/img/v2/fields/types/numerical/number.png)
29+
![Cell display](/img/v2/fields/types/numerical/number-display.png)
3030

3131
---
Lines changed: 22 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,24 +1,32 @@
11
---
22
title: 'Percent'
3-
description: 'This article explains how to create & work with a Percent field.'
3+
description: 'This article explains how to create and use a Percent field.'
44
tags: ['Fields', 'Field types', 'Numerical types', 'Percent']
55
keywords: ['Fields', 'Field types', 'Numerical types', 'Percent', 'Create percent field']
66
---
77

8+
The **Percent** field is a numerical field used to store percentage values. It is useful for data such as completion rates, discount percentages, or performance metrics.
89

9-
`Percent` field type is used to store percentage values. Use cases include storing `discount`, `tax`, etc.
10+
<Callout type="warning">Values are entered as whole numbers and displayed with a percentage sign (e.g., **75** is shown as **75%**).</Callout>
1011

11-
## Create a percent 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 `Percent` from the dropdown.
15-
4. Set default value for the field (Optional).
16-
5. Click on `Save Field` button.
12+
## Create a Percent field
1713

18-
![image](/img/v2/fields/types/percent.png)
14+
1. Click the `+` icon next to the last field in your table.
15+
2. Enter a name for the field.
16+
3. Select **Percent** from the list of field types.
17+
4. (Optional) Enable **Display as progress** to show the percentage as a progress bar.
18+
5. (Optional) Set a default value for the field and add a description.
19+
6. Click **Save field** to add the field to your table.
1920

20-
## Similar numerical fields
21-
Following are the other numerical fields available in NocoDB, with some custom add-on features.
22-
- [Number](/docs/product-docs/fields/field-types/numerical/number)
23-
- [Decimal](/docs/product-docs/fields/field-types/numerical/decimal)
24-
- [Currency](/docs/product-docs/fields/field-types/numerical/currency)
21+
Refer to the general guidelines on [creating a field](/docs/product-docs/fields#create-a-field).
22+
23+
<Callout type="info"> The **Percent** field does not include a `Show thousand separator` option.</Callout>
24+
25+
## Cell display
26+
27+
The **Percent** field appears as a numeric cell in the table, right-aligned by default.
28+
29+
- When **Display as progress** is enabled, the value is represented as a progress bar.
30+
- Without progress display, the value appears as a standard percentage.
31+
32+
![Cell display](/img/v2/fields/types/numerical/percent-display.png)
137 KB
Loading
138 KB
Loading
138 KB
Loading
-63.5 KB
Binary file not shown.
138 KB
Loading

0 commit comments

Comments
 (0)