> ## Documentation Index
> Fetch the complete documentation index at: https://docs.osto.one/llms.txt
> Use this file to discover all available pages before exploring further.

# Managing Users & Groups

> Onboard your team into Osto and organize them into Usergroups for role-based policy targeting.

A default group called **Common** ships with every account; new users land in Common unless you create them in another group.

> **Path:** Assets → Endpoint Users

## Creating a Usergroup

1. Go to **Assets → Endpoint Users**.
2. Click **Create Usergroup +**.
3. Fill in:
   * **Name** (required) — e.g. *Developers*, *Marketing*, *Contractors*.
   * **Description** (optional) — helpful for future you when the group list grows.
4. Click **Save**. The group appears in the list with a count of 0 users.

## Editing or deleting a Usergroup

* **Edit:** open the group from the list, update the name or description, and save.
* **Delete:** click the group's **delete** icon. A group can only be deleted when it contains zero users — move users out first.

<Note>
  The default **Common** group can't be deleted.
</Note>

## Adding users

You can add users manually or in bulk via CSV.

### Add Manually

1. Go to **Assets → Endpoint Users** and locate the target Usergroup.
2. Click **+ Add Users** on that group's row.
3. In the dialog, the **+ Add Manually** tab is selected by default. Fill in:
   * **Name** (required)
   * **Email** (required)
   * **Date of Birth** (optional, DD-MM-YYYY)
   * **Phone Number** (optional, with country-code dropdown — defaults to your account's region)
4. Click **Save**. The user receives an email with a link to download the Osto agent.

### Import via CSV

1. In the **Add User** dialog, switch to the **Import** tab.
2. Click **Download Sample CSV** to grab the template with the right column headers.
3. Fill it with your user list and save.
4. Click **Upload CSV** and select your file.
5. Save. Each user receives the same agent-install email.

## Editing or removing a user

* **Edit:** click the **edit (pencil)** icon on the user's row. You can update **Name, Email, Date of Birth, and Phone Number**.
* **Remove:** click the user's **delete (trash)** icon. The user is unenrolled and their agent stops reporting in. Policies that targeted them via group continue to apply to others.

<Note>
  The Edit User dialog doesn't include a group selector. Moving an existing user between groups isn't supported from the edit view today — if you need to reorganize users across groups, talk to your Osto contact.
</Note>

## Agent install status

The **App Installed** column shows the agent's status per user:

* **Red dot** — agent not yet installed (the user hasn't followed the email link yet).
* **Green dot** — agent installed and reporting in.

When no user has installed the agent, you'll see a warning banner at the top: *"No users have installed the agent application. See details."*

## Related

* [User Protection Policy](/how-to-guides/policy-configuration/user-protection-policy) — the policies that apply to users in each group (Device Control, App Control, Domain Filtering, DLP).
* [Core Concepts](/getting-started/core-concepts) — how Endpoint Users fit into the broader asset model.