> For the complete documentation index, see [llms.txt](https://docs.gaiodataos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gaiodataos.com/tools/tasks/etl/users.md).

# Users

<figure><img src="/files/qYW0kNEpZp7YqMK3caiV" 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
