# Users

<figure><img src="https://1671598980-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0muDd0LkZG6CmTQvGQ4D%2Fuploads%2FBUmQmSbAZSGhzEIxV31o%2FUsers.png?alt=media&#x26;token=f7a3dadb-1c29-4b1a-8a74-696838d3f018" alt=""><figcaption></figcaption></figure>

The **User** task in **Gaio DataOS** allows you to generate a table containing information about **all registered users** on the platform.\
This feature is particularly useful for access control, user management, governance reporting, and auditing flows based on user roles and permissions.

***

## How to Use

### **1. Open the Task**

Navigate to:\
**Tasks > ETL > User**

***

### **2. Define the Result Table Name**

* **Result table**: Enter the name of the table that will store the user data (e.g., `users_table`, `platform_users`, etc.).

***

### **3. Select the Desired Columns**

You can choose which user attributes to include in the output table:

| Column         | Description                                     |
| -------------- | ----------------------------------------------- |
| **Name**       | Full name of the user                           |
| **Email**      | Associated email address                        |
| **Created at** | Date the user account was created               |
| **Group**      | Group or permission set the user belongs to     |
| **Role**       | User access level (e.g., Admin, Editor, Viewer) |

> &#x20;Select only the fields you need for your process or report.

***

### **4. Save and Use**

* Click **Save** to add the task to your flow.
* Upon execution, the system will generate a table with **one row per user**, using the selected columns.

This table can be used for joins, permission validation, governance dashboards, or user-based filtering in flows and reports.

***

#### Use Cases

* Build governance dashboards to list all platform users
* Track user access levels, roles, and group associations
* Audit who has access to which environments or data
* Cross-reference users with logs or activity history