> ## Documentation Index > Fetch the complete documentation index at: https://docs.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. Users table showing columns for name, email, position, sign-in methods, type, role, status, created at, and MFA status, with search, filters, and Add User controls Organization administrators can add, invite, and assign users from this page. Use these controls when someone needs access to your workspace or apps. ## 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={"theme":{"light":"github-light","dark":"github-dark"}} --- 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. The dropdown menu provides two options: **Add User** for creating internal users and **Invite User** for inviting external guest users. Add User dropdown menu showing Add User option for internal users and Invite User option for external users Create a new internal user in this client organization. Once inside Launchpad, navigate to the **Users** page located on the left-hand sidebar. Once inside **Users** click the `+Add User` button and select `Add User`. Configure the required details for the new user. The form includes General Information, Active Sign In Methods, and Assign App sections. Add User form with fields for first name, last name, position, role, email, country code, phone number, account status toggle, access level, active sign-in methods, and KODE OS app assignment with role and site selection | 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` | | Account Status | `Toggle On/Off` | | Access Level | `Permanent or Temporary` | | Active Sign-In Methods | `Choose Sign-In Method` | Once you have configured the required user details, click `Save` to create the user. Invite an existing user from a trusted organization as a guest. You can invite a user only if they already exist as an **Internal** user in a trusted organization available to this environment. If they do not have that account, they will not receive the invite. Once inside Launchpad, navigate to the **Users** page located on the left-hand sidebar. Once inside **Users** click the `+Add User` button and select `Invite User`. Configure the required details for the invited user. The form includes General Information and Assign App sections. Invite User form with fields for trusted organizations, email, position, role, access level, and KODE OS app assignment with role and site selection | Field | Example Configuration | | ------------------------------------------------------------------------------------------------------------ | ---------------------------------- | | Trusted Organizations | `Acme Corp` | | Email | `jane.smith@acme.com` | | Position | `Facilities Manager` | | Role | `Admin`, `Restricted`, `View Only` | | Access Level | `Permanent or Temporary` | Sign-in methods are inherited from the parent organization and don't require configuration when inviting users. Once you have configured the required user details, click `Save` to invite the user. ### Assign KODE OS after client creation Creating a client adds you to that client with Launchpad Admin access. It does **not** assign the KODE OS app or a KODE OS role. Before you can use KODE OS in that client: 1. Open your user record on the **Users** page. 2. Select `Assign App` next to **KODE OS**. 3. Choose a KODE OS role and assign the buildings you need. 4. Save the assignment. Guests who have not accepted an invite appear as **Pending**. Setup emails expire after 24 hours. Resend the setup email from the user's three-dot menu if the link expires. Users who sign in successfully but see no KODE OS apps usually lack an app assignment. Open the user record, select `Assign App` next to **KODE OS**, then choose a role and buildings. ## 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={"theme":{"light":"github-light","dark":"github-dark"}} --- 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: Once inside Launchpad, navigate to the **Users** page located on the left-hand sidebar. Select a user from the list of users. You will be redirected to their **dedicated** page. The user's dedicated page displays their general information, user type (Internal or Guest), and assigned apps. From here, you can edit details, manage their account, and control KODE OS access. User detail page showing general information with name, email, phone number, status, role, position, invited date, trusted organization, and access level, plus KODE OS app assignment with role and Edit Role and Unassign App buttons You can complete the following actions: * Use the icon to edit user details. * Use the 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 If a user cannot sign in after invite, confirm their sign-in method matches the workspace default (email password versus SSO). Updating the method on the user record resolves many login failures. You can only change the sign-in method or resend the setup email for internal users.