Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
36 changes: 14 additions & 22 deletions content/docs/fields/field-types/text-based/email.mdx
Original file line number Diff line number Diff line change
@@ -1,35 +1,27 @@
---
title: 'Email'
description: 'This article explains how to create & work with an Email field.'
description: 'This article explains how to create and use an Email field.'
tags: ['Fields', 'Field types', 'Text based types', 'Email']
keywords: ['Fields', 'Field types', 'Text based types', 'Email', 'Create email field']
---

The **Email** field is a text-based field designed specifically for storing email addresses. It is a specialized version of the **Single line text** field with the following enhancements:

`Email` field is text based field custom-built for storing E-mail IDs. It is a special type of `Single line text` field with
- Optional validation for Email ID
- Cell display as clickable link
- Optional validation to ensure values follow a valid email format
- Display of values as clickable email links

## Create an `Email` field
1. Click on `+` icon to the right of `Fields header`
2. On the dropdown modal, enter the field name (Optional).
3. Select the field type as `Email` from the dropdown.
4. Enable validation by toggling the `Validate Email` checkbox (Optional).
5. Set default value for the field (Optional).
6. Click on `Save Field` button.
## Create an Email field

![image](/img/v2/fields/types/email.png)
1. Click the `+` icon next to the last field in your table.
2. Enter a name for the field.
3. Select **Email** as the field type.
4. (Optional) Enable validation by toggling the **Validate Email** option.
5. (Optional) Set a default value for the field and add a description.
6. Click **Save field** to add it to your table.

<Callout type="note">
- Specify default value without quotes.
- Validation only ensures that the value entered is a valid email ID. It does not check if the email ID exists.
</Callout>
Refer to the general guidelines on [creating a field](/docs/product-docs/fields#create-a-field).

## Similar text based fields
Following are the other text based fields available in NocoDB, custom-built for specific use cases.
- [Single line text](/docs/product-docs/fields/field-types/text-based/single-line-text)
- [Long text](/docs/product-docs/fields/field-types/text-based/long-text)
- [URL](/docs/product-docs/fields/field-types/text-based/url)
- [Phone](/docs/product-docs/fields/field-types/text-based/phonenumber)
<Callout type="note">Validation only ensures the format is a valid email address; it does not verify whether the email address exists</Callout>

---

46 changes: 23 additions & 23 deletions content/docs/fields/field-types/text-based/long-text.mdx
Original file line number Diff line number Diff line change
@@ -1,39 +1,39 @@
---
title: 'Long text'
description: 'This article explains how to create & work with a Long text field.'
description: 'This article explains how to create and use a Long text field.'
tags: ['Fields', 'Field types', 'Text based types', 'Long text']
keywords: ['Fields', 'Field types', 'Text based types', 'Long text', 'Create long text field']
---

The **Long text** field is a text-based field that supports multiple lines of text. It is ideal for storing extended content such as descriptions, notes, or comments.

`Long Text` field is text based field that allows text in multiple lines. It is useful for storing lengthy text like description, notes, etc.
<Callout type="warning">Limit: 100,000 characters</Callout>

## Create a `Long Text` field
1. Click on `+` icon to the right of `Fields header`
2. On the dropdown modal, enter the field name (Optional).
3. Select the field type as `Long text` from the dropdown.
4. Set default value for the field (Optional).
5. Click on `Save Field` button.
## Create a Long text field

![image](/img/v2/fields/types/longtext.png)
1. Click the `+` icon next to the last field in your table.
2. Enter a name for the field.
3. Select **Long text** from the list of field types.
4. (Optional) Enable **Rich text** formatting. Learn more [here](/docs/product-docs/fields/field-types/text-based/rich-text).
5. (Optional) Set a default value for the field and add a description.
6. Click **Save field** to add the field to your table.

:::note
- Specify default value without quotes.
- Use `Enter` key to add new line.
:::
Refer to the general guidelines on [creating a field](/docs/product-docs/fields#create-a-field).

### Cell display
`Long Text` field is displayed as a single line text field in the table view. Click on the expand icon in the cell to view the full text.
<Callout type="info">Enter the default value without quotes. Use the `Enter` key to add a new line.</Callout>

![image](/img/v2/fields/long-text-expand.png)
![image](/img/v2/fields/long-text-expand-2.png)
## Cell display

The **Long text** field appears as a standard text cell in the table. The number of visible lines depends on the row height.

## Similar text based fields
Following are the other text based fields available in NocoDB, custom-built for specific use cases.
- [Single line text](/docs/product-docs/fields/field-types/text-based/single-line-text)
- [URL](/docs/product-docs/fields/field-types/text-based/url)
- [Email](/docs/product-docs/fields/field-types/text-based/email)
- [Phone](/docs/product-docs/fields/field-types/text-based/phonenumber)
![image](/img/v2/fields/types/long-text/expand.png)

Double-clicking the cell, or pressing the `Enter` key while the cell is selected, expands the editor to display more lines for inline editing.

![image](/img/v2/fields/types/long-text/expand-3.png)

Alternatively, click the **Expand** icon in the cell to pop out a larger editor for easier editing. Pop-up editor can be resized by dragging its bottom-right corner & moved around by dragging its header.

![image](/img/v2/fields/types/long-text/expand-2.png)

---
34 changes: 12 additions & 22 deletions content/docs/fields/field-types/text-based/phonenumber.mdx
Original file line number Diff line number Diff line change
@@ -1,33 +1,23 @@
---
title: 'Phone Number'
description: 'This article explains how to create & work with a Phone number field.'
description: 'This article explains how to create and use a Phone number field.'
tags: ['Fields', 'Field types', 'Text based types', 'Phone number']
keywords: ['Fields', 'Field types', 'Text based types', 'Phone number', 'Create phone number field']
---

The **Phone number** field is a text-based field designed for storing phone numbers. It provides an option to validate values to ensure they follow a valid phone number format.

`Phone number` field is text based field that allows you to store phone numbers. It also allows you to validate the phone number.
## Create a Phone number field

## Create a `Phone number` field
1. Click on `+` icon to the right of `Fields header`
2. On the dropdown modal, enter the field name (Optional).
3. Select the field type as `Phonenumber` from the dropdown.
4. Enable validation by toggling the `Validate Phonenumber` checkbox (Optional).
5. Set default value for the field (Optional).
6. Click on `Save Field` button.
1. Click the `+` icon next to the last field in your table.
2. Enter a name for the field.
3. Select **Phone number** as the field type.
4. (Optional) Enable validation by toggling the **Validate Phone number** option.
5. (Optional) Set a default value for the field and add a description.
6. Click **Save field** to add it to your table.

![image](/img/v2/fields/types/phonenumber.png)

<Callout type="note">
- Specify default value without quotes.
- Validation only ensures that the value entered is a valid phone number. It does not check if the phone number exists.
</Callout>

## Similar text based fields
Following are the other text based fields available in NocoDB, custom-built for specific use cases.
- [Single line text](/docs/product-docs/fields/field-types/text-based/single-line-text)
- [Long text](/docs/product-docs/fields/field-types/text-based/long-text)
- [URL](/docs/product-docs/fields/field-types/text-based/url)
- [Email](/docs/product-docs/fields/field-types/text-based/email)
Refer to the general guidelines on [creating a field](/docs/product-docs/fields#create-a-field).

<Callout type="note">Validation only ensures the format is a valid phone number; it does not verify whether the number exists</Callout>

---
102 changes: 59 additions & 43 deletions content/docs/fields/field-types/text-based/rich-text.mdx
Original file line number Diff line number Diff line change
@@ -1,37 +1,37 @@
---
title: 'Rich text'
description: 'This article explains how to create & work with a Rich text field.'
description: 'This article explains how to create and use a Rich text field.'
tags: ['Fields', 'Field types', 'Text based types', 'Rich text']
keywords: ['Fields', 'Field types', 'Text based types', 'Rich text', 'Create rich text field']
---

The **Rich text** field is an extension of the **Long text** field that supports text formatting. It allows you to style content with options such as bold, italic, underline, strikethrough, horizontal rules, ordered and unordered lists, code blocks, quotes, and more.

`Rich Text` field is text based field & is extension of `Long text` that allows you to add formatting to the text. You can add text formatting like bold, italic, underline, strikethrough, horizontal rule, ordered list, unordered list, code, quote, etc.
<Callout type="warning">Limit: 100,000 characters</Callout>

## Create a `Rich Text` field
1. Click on `+` icon to the right of `Fields header`
2. On the dropdown modal, enter the field name (Optional).
3. Select the field type as `Long text` from the dropdown.
4. Enable `Rich Text` toggle field.
5. Set default value for the field (Optional).
6. Click on `Save Field` button.
## Create a Rich text field

![image](/img/v2/fields/types/richtext.png)
1. Click the `+` icon to the right of the **Fields** header.
2. Enter a field name (optional).
3. Select **Long text** as the field type.
4. Enable the **Rich text** toggle.
5. (Optional) Set a default value for the field and add a description.
6. Click **Save field** to add it to your table.

:::note
- Specify default value without quotes.
- Use `Enter` key to add new line.
:::
Refer to the general guidelines on [creating a field](/docs/product-docs/fields#create-a-field).

### Cell display
`Rich Text` field is displayed as a single line text field in the table view. Click on the expand icon in the cell to view the full text.
<Callout type="info">Enter the default value without quotes. Use the `Enter` key to add a new line.</Callout>

![image](/img/v2/fields/long-text-expand.png)
![image](/img/v2/fields/long-text-expand-2.png)
## Cell display


In the table view, the **Rich text** field appears as a single-line cell. To view or edit the full content, click the **Expand** icon.

![image](/img/v2/fields/types/long-text/rich-text-expand.png)


## Formatting options
NocoDB supports markdown syntax for formatting the text. Following are the supported formatting options.
NocoDB supports Markdown syntax for formatting the text. Sections below explain various formatting options available in the rich text editor.

### Heading
To create a heading, prefix `#` symbol preceding your heading text. The number of # symbols employed will dictate the heading's hierarchy level and typeface size. Three levels of headings are supported.
Expand All @@ -47,43 +47,55 @@ To create a heading, prefix `#` symbol preceding your heading text. The number o
### Text formatting
You can emphasise text with bold, italic, strikethrough or underline formatting options. Table below shows syntax, keyboard shortcut, example & output for each formatting option.

| Style | Syntax | Keyboard shortcut | Example | Output |
| --- | --- | --- | --- | --- |
| Bold | `**bold text**` | `Ctrl/Cmd + B` | `**This is bold text**` | **This is bold text** |
| Italic | `*italicized text*` | `Ctrl/Cmd + I` | `*This is italicized text*` | *This is italicized text* |
| Strikethrough | `~~strikethrough text~~` | `Ctrl/Cmd + Shift + X` | `~~This is strikethrough text~~` | ~~This is strikethrough text~~ |
| Underline | | `Ctrl/Cmd + U` | `This is underlined text` | <u>This is underlined text</u> |
| Style | Syntax | Keyboard shortcut | Output |
|---------------|--------------------------|------------------------|--------------------------------|
| Bold | `**bold text**` | `Ctrl/Cmd + B` | **bold text** |
| Italic | `*italicized text*` | `Ctrl/Cmd + I` | *italicized text* |
| Strikethrough | `~~strikethrough text~~` | `Ctrl/Cmd + Shift + X` | ~~strikethrough text~~ |
| Underline | | `Ctrl/Cmd + U` | <u>underlined text</u> |


### Quote block
You can quote text with a `>`

**Usage**
```
normal text
> quoted text
```

**Display**

normal text
> quoted text

### Code block
Code block can be created by using (3 backticks) before & after the code.
Code block can be created by using (3 backticks) before & after the code.

**Usage**

````
```
This is a code block
```
````

**Display**

```
This is a code block
```

### Link
You can create an inline link by using `Link` menu option in the rich text toolbar
Use the **Link** option in the rich text toolbar to add inline links. Alternatively, you can use markdown syntax `[link text](URL)`.


![image](/img/v2/fields/types/richtext-links.png)

### Bullet List
You can create unordered list by using `Bulleted list` menu option in the rich text toolbar or by preceding the text with `-` `+` or `*` symbol.
You can create an unordered list using the **Bulleted list** option in the toolbar or by starting lines with `-`, `+`, or `*`.

**Usage**

```
- Item 1
- Item 2
Expand All @@ -95,6 +107,8 @@ You can create unordered list by using `Bulleted list` menu option in the rich t
* Item 2
```

**Display**

- Item 1
- Item 2

Expand All @@ -104,34 +118,36 @@ You can create unordered list by using `Bulleted list` menu option in the rich t
* Item 1
* Item 2

:::note
You can create nested lists by using `tab` key & `shift + tab` key to indent & outdent the list items.
:::
<Callout type="info">You can create nested lists by using `tab` key & `shift + tab` key to indent & outdent the list items</Callout>

### Numbered List
You can create ordered list by using `Numbered list` menu option in the rich text toolbar or by preceding the text with `1.` symbol.
You can create an ordered list using the **Numbered list** option in the toolbar or by prefixing text with numbers.

**Usage**

```
1. Item 1
2. Item 2
```

**Display**

1. Item 1
2. Item 2

### Task list
You can create task lists by using `Task list` menu option in the rich text toolbar or by preceding the text with `[ ]` symbol. You can mark the task as completed by using `[x]` symbol.
You can create task lists using the **Task list** option in the toolbar or with `[ ]` and `[x]` for incomplete and completed tasks.

**Usage**

```
[ ] Item 1
[x] Item 2
```
- [ ] Item 1
- [x] Item 2


## Similar text based fields
Following are the other text based fields available in NocoDB, custom-built for specific use cases.
- [Single line text](/docs/product-docs/fields/field-types/text-based/single-line-text)
- [URL](/docs/product-docs/fields/field-types/text-based/url)
- [Email](/docs/product-docs/fields/field-types/text-based/email)
- [Phone](/docs/product-docs/fields/field-types/text-based/phonenumber)
**Display**

- [ ] Item 1
- [x] Item 2

---
12 changes: 2 additions & 10 deletions content/docs/fields/field-types/text-based/single-line-text.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ The **Single line text** field is used to store short, freeform text values. It

<Callout type="warning">Limit: 100,000 characters</Callout>

## Create a single line text field
## Create a Single line text field

1. Click on the `+` icon next to the last field in your table.
2. Enter a name for the field.
Expand All @@ -21,12 +21,4 @@ Refer here for generic guidelines on [creating a field](/docs/product-docs/field

<Callout type="info">Specify default value as is, without quotes</Callout>

## Similar text based fields
Following are the other text based fields available in NocoDB, custom-built for specific use cases.
- [Long text](/docs/product-docs/fields/field-types/text-based/long-text)
- [URL](/docs/product-docs/fields/field-types/text-based/url)
- [Email](/docs/product-docs/fields/field-types/text-based/email)
- [Phone](/docs/product-docs/fields/field-types/text-based/phonenumber)



---
Loading
Loading