## Overview
The Members widget in Labii extends the functionality of the Member widget, offering users the ability to select one or multiple team members from a list of options within the platform. This versatile widget empowers users with the flexibility to choose one or more team members, catering to various collaboration or assignment needs. Whether it's assigning tasks to multiple individuals or creating group notifications, this widget streamlines the selection process, enabling efficient communication and collaboration among team members within the Labii platform.
## Use case
1. Use this widget to list of assignees of a task.
## Configuration
The widget operates seamlessly without extra setup, allowing selection from all members by default. Using the configuration options, you can customize the selectable members and set notification messages for users accordingly, enabling precise control over the selection process and user communication.
* **Name display** - How do you want to display the name?
* Full Name
* Initials
* **Team** - Select a team to limit the selection of members. If not selected, all active users will be selectable.
* **Should limit to oneself** - If this box is ticked, individuals can only choose themselves.
* **Email subject** - By providing the value here, you can customize the email subject. You can use [variables](https://docs.labii.com/api/variables) to replace some of data.
* **Email body** - By providing the value here, you can customize the email body.\
\
Variables that can be replaced:\
{{UID}} - The UID of the trigger record.\
{{NAME}} - The name of the trigger record.\
{{ROW}} - The current record with link.
### Examples:
```json
{
"name_display": "full_name",# or initials
"team": {"sid": "xxx", "name": "xxx"}, # (optional) - team sid to limit team member to be selected
"subject": "xxx", # (optional) - email subject
# subject variables
# {{UID}} - the UID of the current record
# {{NAME}} - the Name of the current record
"body": "xxx", # (optional) - email body
# both subject and body support the following variables
# {{UID}}
# {{NAME}}
# {{ROW}} - the current row with link
}
```
## Views
See the interface of the widget in the following views.
### **Readonly view**
Readonly view display the values of the column.
### **Edit view**
The Edit view is the interface that allows you to modify the value.
### **Form view**
The Form view is the field integrated into the add form for collecting values when creating a new record.
The Form view is same as the Edit view.
## Data
Each widget in Labii stores data in a unique manner; refer below to understand how data from this widget is stored.
### Data format
JSON array with keys of `sid` and `name`:
```json
[{"sid":"", "name":""}]
```
### **Default value**
The Default Value field within the column allows you to specify the default value when a record is created.
Default value shall be List of names separated by "comma(,)" in the format of "`[First name] [Last name]`". For example: `John Goodway, Jim Sam`
### **Import value**
The Import Value is the value you need to include in your Excel table for it to be imported into Labii.
Import value shall be List of names separated by "comma(,)" in the format of "`[First name] [Last name]`". For example: `John Goodway, Jim Sam`
