|
1 | 1 | --- |
2 | | -title: 'Multi Select' |
3 | | -description: 'This article explains how to create & work with a Multi select field.' |
| 2 | +title: 'Multi select' |
| 3 | +description: 'This article explains how to create and use a Multi select field.' |
4 | 4 | tags: ['Fields', 'Field types', 'Select based types', 'Multi select'] |
5 | 5 | keywords: ['Fields', 'Field types', 'Select based types', 'Multi select', 'Create multi select field'] |
6 | 6 | --- |
7 | 7 |
|
| 8 | +The **Multi select** field allows you to choose multiple options from a predefined list. It is useful for fields like skills, tags, or applicable categories. |
8 | 9 |
|
9 | | -`Multi Select` fields allow you to select multiple options from a list of options. The options can be defined in the field configuration. |
| 10 | +## Create a Multi select field |
10 | 11 |
|
11 | | -## Create a multi select 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 `MultiSelect` from the dropdown. |
15 | | -4. Click on `Add option` button to add options. |
16 | | -5. Set default value for the field. The options are populated in the dropdown. Since its multi select, you can select multiple options as default value (Optional). |
17 | | -6. Click on `Save Field` button. |
| 12 | +1. Click the `+` icon next to the last field in your table. |
| 13 | +2. Enter a name for the field. |
| 14 | +3. Select **Multi select** from the list of field types. |
| 15 | +4. Click **Add option** to define available options. |
| 16 | +5. (Optional) Set default values for the field from the defined options. |
| 17 | +6. Click **Save field** to add the field to your table. |
18 | 18 |
|
19 | | - |
| 19 | +Refer to the general guidelines on [creating a field](/docs/product-docs/fields#create-a-field). |
20 | 20 |
|
21 | | -<Callout type="note"> |
22 | | -Use of `,` is not allowed for option values. |
23 | | -</Callout> |
| 21 | + |
24 | 22 |
|
25 | | -### Configure color for options |
26 | | -You can re-configure background color for each option. This is useful when you want to highlight certain options. For example, you can configure `High` option to have `red` background color. |
27 | | -To configure, click on the `color` icon next to the option. Select the color from the color picker and click on `Save Field` button. |
| 23 | +<Callout type="note"> `✨✨✨` **NocoAI** can assist in generating options for your Multi select field. Click the **Auto Suggest** button to get AI-generated suggestions based on your field name & existing options.</Callout> |
28 | 24 |
|
29 | | - |
| 25 | +## Edit options |
30 | 26 |
|
31 | | -### Re-order options |
32 | | -You can re-order options by dragging and dropping the options. To re-order, click on the `drag` icon next to the option and drag it to the desired position. Click on `Save Field` button to save the order. |
| 27 | +### Rename options |
| 28 | +Click on the option text box to rename an option. Save changes using **Save field**. |
33 | 29 |
|
34 | | - |
| 30 | +### Configure colors |
| 31 | +Assign background colors to options to visually distinguish them. For example, tag `Urgent` as red to highlight importance. |
| 32 | +Click the **color** icon next to an option, select a color, and save changes. |
35 | 33 |
|
36 | | -<Callout type="info">The order defined for the options will be used in cells dropdown as well</Callout> |
| 34 | + |
37 | 35 |
|
| 36 | +### Reorder options |
| 37 | +Drag and drop options using the **drag** icon to reorder them. The new order is reflected in the dropdown inside cells. |
38 | 38 |
|
39 | | -### Edit options |
40 | | -You can rename options by clicking on the associated option text box. Click on `Save Field` button to save the changes. |
| 39 | + |
| 40 | + |
| 41 | +<Callout type="info">The order you define for options is preserved in the cell dropdown list.</Callout> |
41 | 42 |
|
42 | 43 | ### Delete options |
43 | | -You can delete options by clicking on the `x` icon next to the option. You can undo the delete by clicking on the `undo` icon next to the option. Click on `Save Field` button to save the changes. |
| 44 | +Click the `x` icon to delete an option. Deleted options can be restored using the **undo** icon before saving. |
| 45 | + |
| 46 | + |
| 47 | + |
| 48 | +<Callout type="warning"> Removing an option clears it from all cells where it was selected. If the deleted option was set as a default value, the default will be cleared. </Callout> |
44 | 49 |
|
45 | | -<Callout type="note"> |
46 | | -- On removing an option, the option value will be removed from all the cells. |
47 | | -- If the option value is set as default value for the field, then the default value will be removed. |
48 | | -</Callout> |
| 50 | +## Cell display |
49 | 51 |
|
50 | | - |
| 52 | +The **Multi select** field displays as a dropdown in table cells, showing the configured options with their respective colors. Multiple options can be selected for a single cell. |
51 | 53 |
|
52 | | -## Similar select based fields |
53 | | -- [Single select](/docs/product-docs/fields/field-types/select-based/single-select) |
| 54 | +<img src="/img/v2/fields/types/multi-select/display.png" alt="display" style={{width: "80%"}} /> |
| 55 | + |
| 56 | +--- |
0 commit comments