diff --git a/packages/noco-docs/docs/070.fields/040.field-types/080.user-based/010.user.md b/packages/noco-docs/docs/070.fields/040.field-types/080.user-based/010.user.md new file mode 100644 index 0000000000..b4d02fd244 --- /dev/null +++ b/packages/noco-docs/docs/070.fields/040.field-types/080.user-based/010.user.md @@ -0,0 +1,30 @@ +--- +title: 'User' +description: 'This article explains how to create & work with a User field.' +tags: ['Fields', 'Field types', 'User'] +keywords: ['Fields', 'Field types', 'User', 'Create User field'] +--- + +`User` field type allows you to assign a user from your current workspace to a record. For example, you can create a `Task` table with a `User` field type to assign a task to a user. You can also configure the field to allow assigning multiple users to a record. + +## Create a User 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 `User` from the dropdown. +4. Configure `Allow adding multiple users` toggle field (Optional). +5. Configure default value (Optional) +6. Click on `Save Field` button. + +![image](/img/v2/fields/types/user-field.png) + +### Cell display +`User` field display is quite identical to `Select` field. It is displayed as a dropdown in the table view. Click on the dropdown to select a user. If `Allow adding multiple users` is enabled, you can select multiple users from the dropdown. + +![image](/img/v2/fields/types/user-field-cell.png) + +:::note +- If a user is removed from workspace, the user will be removed from the dropdown list. If such user was assigned to a record already, the user will be displayed as is. +- To remove a user from a record, click on the `x` icon next to the user name. +- If display name is not set for a user, the user's email address will be displayed. +::: + diff --git a/packages/noco-docs/docs/070.fields/040.field-types/080.user-based/_category_.json b/packages/noco-docs/docs/070.fields/040.field-types/080.user-based/_category_.json new file mode 100644 index 0000000000..1cb0a5eeee --- /dev/null +++ b/packages/noco-docs/docs/070.fields/040.field-types/080.user-based/_category_.json @@ -0,0 +1,5 @@ +{ + "label": "User based", + "collapsible": true, + "collapsed": true +} \ No newline at end of file diff --git a/packages/noco-docs/static/img/v2-unannotated/fields/types/user-field.png b/packages/noco-docs/static/img/v2-unannotated/fields/types/user-field.png new file mode 100644 index 0000000000..2aaf6381ef Binary files /dev/null and b/packages/noco-docs/static/img/v2-unannotated/fields/types/user-field.png differ diff --git a/packages/noco-docs/static/img/v2/fields/types/user-field-cell.png b/packages/noco-docs/static/img/v2/fields/types/user-field-cell.png new file mode 100644 index 0000000000..d3b6c7bb88 Binary files /dev/null and b/packages/noco-docs/static/img/v2/fields/types/user-field-cell.png differ diff --git a/packages/noco-docs/static/img/v2/fields/types/user-field.png b/packages/noco-docs/static/img/v2/fields/types/user-field.png new file mode 100644 index 0000000000..58a3c4a7a4 Binary files /dev/null and b/packages/noco-docs/static/img/v2/fields/types/user-field.png differ