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

# Users

> Learn how to create and manage client users

The **Users** page, accessible from the left-hand sidebar, displays all users in your Launchpad workspace. It allows you to create new internal users directly, invite existing users from external organizations, and provides detailed controls for managing existing users regardless of origin.

## User Types

In Launchpad, users are categorized as either **Internal Users** or **Guest Users**. These profiles define a user's type and determine what can be managed for a given user.

* Internal users represent entities whose account and user profile both reside within the same organization. Internal users authenticate directly using the credentials and sign-in methods issued by your organization.

* Guest users represent entities whose user profile resides in your organization while their account resides in a different (external) organization. They continue to authenticate using the credentials and sign-in methods issued by their parent organization.

```mermaid actions={false} theme={null}
---
config:
  layout: TB
  theme: neutral
---
flowchart LR
    %% Your Organization
    subgraph OrgA["Organization A"]
        IU_Profile["Internal User Profile"]
        EU_Profile["External User Profile"]
        IU_Account["Account"]
    end

    %% External Organization
    subgraph OrgB["Organization B"]
        EU_Account["Account"]
    end

    %% Connections
    IU_Account -. connected ..- IU_Profile
    IU_Profile -. connected .- IU_Account

    EU_Account -. connected ....- EU_Profile
    EU_Profile -. connected .- EU_Account

    %% Labels / Classes
    classDef internal stroke:#FF6D00,fill:none;
    classDef external stroke:#00C853,fill:none;

    class IU_Account,IU_Profile internal;
    class EU_Account,EU_Profile external;
```

## Create Users

You can create or invite users from the **Users** page using the `+Add User` button.

### Add User (Internal)

Follow the steps outlined below to create a new client user.

<Steps>
  <Step title="Open the Users page">
    Once inside Launchpad, navigate to the **Users** page located on the left-hand sidebar.
  </Step>

  <Step title="Click +Add User">
    Once inside **Users** click the `+Add User` button and select `Add User`.
  </Step>

  <Step title="Configure user details">
    Configure the required details for the new user.

    <Expandable defaultOpen={true} title="Example Configuration">
      | Field                                                                                                               | Example Configuration              |
      | ------------------------------------------------------------------------------------------------------------------- | ---------------------------------- |
      | First Name                                                                                                          | `Jane`                             |
      | Last Name                                                                                                           | `Smith`                            |
      | Position                                                                                                            | `Facilities Manager`               |
      | Role                                                                                                                | `Admin`, `Restricted`, `View Only` |
      | Email                                                                                                               | `jane.smith@example.com`           |
      | Country Code                                                                                                        | `United States +1`                 |
      | Phone Number                                                                                                        | `555 123 4567`                     |
      | <Tooltip tip="Toggle on to create the account right away. Leave off to postpone creation.">Account Status</Tooltip> | `Toggle On/Off`                    |
      | Access Level                                                                                                        | `Permanent or Temporary`           |
      | Active Sign-In Methods                                                                                              | `Choose Sign-In Method`            |
    </Expandable>
  </Step>

  <Step title="Save">
    Once you have configured the required user details, click `Save` to create the user.
  </Step>
</Steps>

### Invite User (Guest)

Follow the steps outlined below to invite a new client user.

<Steps>
  <Step title="Open the Users page">
    Once inside Launchpad, navigate to the **Users** page located on the left-hand sidebar.
  </Step>

  <Step title="Click +Add User">
    Once inside **Users** click the `+Add User` button and select `Invite User`.
  </Step>

  <Step title="Configure user details">
    Configure the required details for the new user.

    <Expandable title="Example Configuration" defaultOpen={true}>
      | Field                                                                                                        | Example Configuration              |
      | ------------------------------------------------------------------------------------------------------------ | ---------------------------------- |
      | <Tooltip tip="Select the trusted organization you will invite the user from">Trusted Organizations</Tooltip> | `Acme Corp`                        |
      | Email                                                                                                        | `jane.smith@acme.com`              |
      | Position                                                                                                     | `Facilities Manager`               |
      | Role                                                                                                         | `Admin`, `Restricted`, `View Only` |
      | Access Level                                                                                                 | `Permanent or Temporary`           |
    </Expandable>

    <Info>
      Sign-in methods are inherited from the parent organization and don't require configuration when inviting users.
    </Info>
  </Step>

  <Step title="Save">
    Once you have configured the required user details, click `Save` to invite the user.
  </Step>
</Steps>

## Manage Users

The **Users** page lists all existing users in rows, with each row displaying key details about the respective user. Each user in your organization, whether internal or external, has a dedicated user page that provides a centralized interface to view and manage all details related to a specific user.

```mermaid actions={false} theme={null}
---
config:
  layout: dagre
  theme: neutral
---
flowchart LR
 subgraph s1["Client Organization Users"]
        U1["User 1"]
        U2["User 2"]
        U3["User 3"]
  end
    A["Users Page"] -- view --- A1["Users Table"]
    A1 -- select ---- U1
    U1 -- view & manage --- BIP1["Dedicated Page"]
    A1 -- select --- U2 & U3
    U2 -- view & manage --- BIP2["Dedicated Page"]
    U3 -- view & manage --- BIP3["Dedicated Page"]

    linkStyle 1 stroke:#00C853,fill:none
    linkStyle 2 stroke:#FF6D00,fill:none
    linkStyle 3 stroke:#00C853,fill:none
    linkStyle 4 stroke:#00C853,fill:none
    linkStyle 5 stroke:#FF6D00,fill:none
    linkStyle 6 stroke:#FF6D00
```

To manage a user, follow the steps outlined below:

<Steps>
  <Step title="Open the Users page">
    Once inside Launchpad, navigate to the **Users** page located on the left-hand sidebar.
  </Step>

  <Step title="Select a user">
    Select a user from the list of users. You will be redirected to their **dedicated** page.
  </Step>

  <Step title="Manage the user">
    Once inside the user's dedicated page, you can complete the following actions:

    * Use the <Icon icon="pencil" iconType="solid" /> icon to edit user details.
    * Use the <Icon icon="ellipsis-vertical" iconType="solid" /> icon to manage the user, including deactivating or deleting them, changing their sign-in method, or resending the setup email.
    * Assign or remove assignment for `KODE OS`
    * Assign or change `KODE OS` role

    <Note>
      You can only change the sign-in method or resend the setup email for internal users.
    </Note>
  </Step>
</Steps>