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

# Workspace Management

> Learn how to manage your Workspace settings including general configuration, members, LMS integration, and apps.

Your Workspace is the top-level container for all your Groups, Assistants, and users in Nectir AI. While the Nectir team often creates Workspaces for organizations, as a Workspace Owner you can configure settings to customize how your organization uses the platform.

<Note>
  If your Workspace was created by the Nectir team, you can jump directly to managing the settings below. For new Workspaces, contact [support@nectir.io](mailto:support@nectir.io) for setup assistance.
</Note>

## Access Workspace Settings

To access your Workspace settings, click the settings icon <Icon icon="gear" iconType="solid" /> in the top left corner of your Nectir AI workspace.

## General Settings

In the General Settings tab, you can configure basic Workspace information:

<CardGroup cols="3">
  <Card title="Workspace Avatar" icon="image">
    Click on the current avatar to upload a new image that represents your organization or institution
  </Card>

  <Card title="Workspace Name" icon="pencil">
    Update the Workspace name to reflect your organization's branding or preferred identifier
  </Card>

  <Card title="Workspace ID" icon="copy">
    Use the **Copy** button next to the Workspace ID field to get your unique identifier for LTI integration setup
  </Card>
</CardGroup>

## Members

The Members tab allows Workspace Owners to manually invite educators to the Workspace:

* **Invite New Members**: Click **Invite Members** and enter email addresses or use a shared invitation link - this works the same as inviting users into Groups
* **Assign Roles**: Select appropriate roles for each invited member
* **Bulk Actions**: Multi-select members to perform bulk actions like removing users or changing roles for many members at once

<CardGroup cols="3">
  <Card title="Owner" icon="crown">
    Full administrative access including Workspace settings, member management, and all creation/editing permissions
  </Card>

  <Card title="Editor" icon="pencil">
    Can create and manage Groups and Assistants, but cannot modify Workspace settings or manage members
  </Card>

  <Card title="Member" icon="user">
    Read-only access to view content within Groups they've been added to
  </Card>
</CardGroup>

For detailed information about user roles and permissions, see [User & Access Management](/user-management/inviting-users).

<Note>
  **LTI Integration**: If your Workspace uses LTI integration, member management is typically automated through your LMS. See [LMS Role Mapping](#lms-role-mapping) below to learn how user roles are automatically assigned.
</Note>

## LMS Integration

The LMS Integration tab contains settings for Workspaces that use Learning Management System integration.

### Initial Workspace Setup via LMS

If you're setting up your Workspace for the first time through an LMS integration, refer to platform-specific setup guides:

<CardGroup cols={2}>
  <Card title="Canvas Setup" icon="graduation-cap" href="/getting-started/workspace-setup-canvas">
    Learn how to set up your Workspace through Canvas LTI integration
  </Card>
</CardGroup>

## LMS Role Mapping

Once you connect your Workspace to your LMS, you can configure how LMS roles map to Nectir roles. Workspace Owners can automatically map LMS roles to Nectir roles, streamlining the user management process:

<Frame>
  <img src="https://mintcdn.com/nectir/XcxxEj6IZoS32gfJ/images/lms-role-mapping.png?fit=max&auto=format&n=XcxxEj6IZoS32gfJ&q=85&s=85165c0a5058733ec86f0b4acc00c19d" alt="LMS role mapping configuration" width="2440" height="1688" data-path="images/lms-role-mapping.png" />
</Frame>

<Warning>
  **LTI Integration Required**: This feature is only available for Workspaces with LTI integration set up. Contact support if you need help setting up LTI integration.
</Warning>

### Understanding Role Mapping

LMS role mapping determines what permissions users receive in Nectir based on their role within a specific LMS course. Understanding how this works is critical for proper setup:

**Course-Specific Roles**

Nectir uses the role assigned to a user **within each specific LMS course** to determine their Group permissions. Since users may hold different roles across different courses (for example, a faculty member might be an instructor in some courses and a student in others), their Nectir permissions vary by Group based on their course-specific role.

**Unmapped Roles**

If a user has an LMS role that doesn't map to any Nectir role, Nectir redirects them to the Workspace level without access to the specific Group. Make sure all relevant LMS roles map to appropriate Nectir roles.

**Admin Setup Requirements**

If an LMS administrator is setting up integrations on behalf of instructors, they must be an actual member of the LMS course (ideally with an instructor role) to receive appropriate permissions in Nectir to complete the setup. Having administrator privileges at the institution level isn't enough without course membership.

### Recommended Role Mapping

* **Workspace Owners**: LMS administrators who need full control over the Workspace
* **Workspace Editors**: Faculty members who create and manage Assistants across their courses

### Configuration Steps

<Steps>
  <Step title="Access LMS Integration Settings">
    Access your **Workspace Settings** by clicking on the settings icon on the top left, then click **LMS Integration** on the left sidebar.
  </Step>

  <Step title="Configure Role Mappings">
    On the LMS Integration page, set how each LMS role should map to Nectir roles:

    * **Administrator** → Choose mapping for LMS administrators (typically Owner)
    * **Instructor** → Choose mapping for LMS instructors (typically Editor)
    * **TA/Designer** → Choose mapping for teaching Assistants and course designers
    * **Student** → Choose mapping for students (typically Member)
  </Step>

  <Step title="Save Your Configuration">
    Click **Save Changes** to apply the role mapping configuration.
  </Step>
</Steps>

<Info>
  **Benefits of LMS role mapping:**

  * **Automatic user provisioning** - Users are created with appropriate permissions when they access through the LMS
  * **Consistent permissions** - Maintains alignment between LMS and Nectir roles
  * **Reduced manual management** - Eliminates the need to individually assign roles to users
  * **Seamless experience** - Users receive the right level of access without additional configuration
</Info>

<Warning>
  **Important**: Role mapping settings only apply to **new users** who join after the mapping is configured. Existing users will retain their current roles and must be updated manually if needed.
</Warning>
