# Onboarding Users to OneLens
## Overview
To ensure **secure and role-appropriate access** across your organization, OneLens requires all other team users to be **explicitly added by an Admin user**. Without this setup, team members cannot sign in or interact with the platform.
Through the following setup you can also:
* **Control** over who has access to OneLens.
* **Align permissions** with user roles and personas.
* Maintain **organizational governance** over their cost visibility and actions.
{% hint style="warning" %}
## NOTE
Only users with the **"Admin"** user type can add or manage other users in OneLens. Make sure you log in with an **admin account**.
{% endhint %}
## Adding a New User
{% stepper %}
{% step %}
**Log in with Admin Access**
Sign in to [OneLens UI](https://app-in.onelens.cloud/) using an email that has **admins privileges.**
{% endstep %}
{% step %}
**Go to User Settings**
* Click **Settings** in the left sidebar.
* Under the **Organization** section, select **User Settings**.
{% endstep %}
{% step %}
**Create User**
The user list appears displaying all the current users along with their status (**Active, Inactive**). Click the **Create User** button located at the top right.
{% endstep %}
{% step %}
**Select User Type**
* **Admin**: Has full platform access and can change organization-wide settings.
* **Member**: Has limited access to specific cost centers with assigned roles.
{% endstep %}
{% step %}
**Enter User Details**
* Enter the user email address, first name and last name.
* Choose the User persona (e.g FinOps Owner, Developer, DevOps Owner)
{% endstep %}
{% step %}
**Assign Cost Centers (Member User Only)**
For members type, select one or more cost centers the user can access.
{% hint style="info" %}
## **Understand Your Cost Center Hierarchy First**
Before assigning, ensure you’re familiar with how cost centers are structured in your organization. This determines what data and actions the user can access.
You can also **view or modify the cost center hierarchy** anytime by going to **Settings → Business Mapping Cost → Organization Cost Center**.
{% endhint %}
{% endstep %}
{% step %}
**Confirm the Creation**
Click **Create** to send out a confirmation mail to the user.
{% endstep %}
{% endstepper %}
## What Happens After
* Once the user is created, their status updates to **Active**.
* The user can then log in to the OneLens platform.
{% hint style="success" %}
[**Read the login guide**](https://docs.onelens.cloud/getting-started/accessing-onelens) to learn how users can access their account.
{% endhint %}
## Managing Existing User Access
You can view and take actions on any user—whether they are **Active or** **Inactive** state.
{% stepper %}
{% step %}
**Open User Settings**
Navigate to **User Settings** via the **Settings** menu.
{% endstep %}
{% step %}
**Find Users**
Use the **search bar** or **status filters** to locate the user.
{% endstep %}
{% step %}
**Access User Actions**
Click the **three horizontal dots** at the end of the user's row to open the menu.
{% endstep %}
{% step %}
**Choose Action**
* **Revoke Access**: Deactivate the user immediately.
* **Edit Access**: Modify user role, persona or access level as per cost centers.
{% endstep %}
{% endstepper %}
## **Access Revocation: Impact & Recovery**
Revoking a user’s access deactivates their account immediately. The user's status will change to **Inactive**.
Once revoked:
* The user will no longer be able to log in.
* Their profile will remain visible with an **Inactive** status.
{% hint style="success" %}
## Reactivating User Access
If access needs to be restored later, follow these steps:
* Open the **three-dot menu** next to the user's row in the User Settings table.
* Click **Re-activate**.
* The user's status updates to **Active**, and their previous access and roles are reinstated.
{% endhint %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.onelens.cloud/getting-started/onboarding-users-to-onelens.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
