Skip to main content
This guide walks through setting up a workspace for your team, inviting members, configuring roles, and organizing shared assistants and projects.

​
Creating a Workspace

When you sign up for IllumiChat, a default workspace is created for you. To create an additional workspace:
1

Open the workspace switcher

Click your workspace name in the top-left corner of the sidebar.
2

Create a new workspace

Click Create Workspace and enter a name for your team (e.g., “Marketing Team” or “Acme Corp”).
3

Configure settings

Set the workspace name, default AI model, and other preferences under Settings.

​
Inviting Team Members

1

Go to Members

Navigate to Settings > Members in your workspace.
2

Send invitations

Click Invite Member, enter their email address, and select a role. You can invite multiple people at once.
3

Members accept the invite

Invited users receive an email with a link to join. Once they accept, they appear in your members list.
Only workspace owners and admins can invite new members.

​
Understanding Roles

Each member is assigned a role that determines what they can do in the workspace.
RoleWhat They Can Do
OwnerEverything — billing, workspace deletion, member management, all assistant and project operations
AdminManage members, create and configure assistants, manage projects and settings
MemberUse assistants, create and view chats, access shared projects
GuestLimited read-only access to specific resources

​
Role Comparison

ActionOwnerAdminMemberGuest
Use assistantsYesYesYesLimited
Create chatsYesYesYesNo
Create assistantsYesYesNoNo
Configure assistantsYesYesNoNo
Manage projectsYesYesNoNo
Invite membersYesYesNoNo
Remove membersYesYesNoNo
Change rolesYesYesNoNo
Manage billingYesNoNoNo
Delete workspaceYesNoNoNo

​
Organizing Assistants

Create assistants for different team functions and control who can access each one.

​
Visibility Settings

VisibilityWho Can AccessBest For
publicAll workspace membersGeneral-purpose assistants
workspaceActive workspace membersTeam-specific assistants
privateCreator, admins, and explicitly granted usersSensitive or experimental assistants

​
Suggested Team Setup

AssistantPurposeVisibility
Customer SupportExternal support queriesPublic
Sales HelperLead qualification and product infoPublic
Internal KBInternal team Q&AWorkspace
HR AssistantEmployee policy questionsPrivate

​
Sharing Projects

Projects contain documents used for retrieval-augmented generation. Control access with visibility and member roles.

​
Project Visibility

VisibilityAccess
workspaceAll workspace members can view and use (editor role)
privateOnly the owner and explicitly added members

​
Adding Members to Private Projects

  1. Open the project
  2. Go to Settings > Members
  3. Add team members and set their role (viewer or editor)
Use workspace visibility for shared knowledge bases that the whole team needs. Use private for department-specific or experimental document sets.

​
Configuring AI Models

Workspace admins can configure which AI models are available to all assistants.
  1. Go to Settings > Models
  2. Add API keys for the providers you want to use (xAI, OpenAI, Anthropic)
  3. Select a default model for the workspace
Each assistant can override the workspace default with its own model selection.

​
Managing the Workspace

​
Changing Member Roles

  1. Go to Settings > Members
  2. Click on a member
  3. Select a new role from the dropdown
  4. Changes take effect immediately

​
Removing Members

  1. Go to Settings > Members
  2. Click the remove button next to the member
  3. Confirm removal
Removing a member immediately revokes their access. Their existing chats remain in the workspace but they can no longer access them.

​
Transferring Ownership

Only the current owner can transfer ownership:
  1. Go to Settings > Members
  2. Click on the member you want to promote
  3. Select Transfer Ownership
  4. Confirm the transfer
You will be downgraded to admin after transferring ownership.

​
Billing

Billing is managed at the workspace level by the owner.
  1. Go to Settings > Billing
  2. View your current plan and usage
  3. Upgrade, downgrade, or manage payment methods
Each workspace has its own subscription. Widget message quotas, member limits, and available features depend on your plan tier.

​
Checklist

Use this checklist when setting up a new team workspace:
  • Workspace created and named
  • Team members invited with appropriate roles
  • AI model API keys configured
  • Shared assistants created with correct visibility
  • Knowledge base projects created and shared
  • Widget deployed (if using external-facing assistants)
  • Billing configured