Team Management
Invite and manage team members with role-based access control across your NexusCommerce tenant.
Overview
The Team settings page lets you invite colleagues, assign roles, and manage user access for your NexusCommerce tenant. All users share the same tenant data; roles control what actions each user can perform.
Key Concepts
Role — A set of permissions that determines what a user can see and do. NexusCommerce has four built-in roles:
| Role | Description |
|---|---|
| Owner | Full access including billing and account deletion. One owner per tenant. |
| Admin | Full access to all features except billing management and tenant deletion. |
| Manager | Read-write access to Products, Orders, Returns, Inventory, Pricing, Ads, and Analytics. Cannot access Settings. |
| Viewer | Read-only access to all sections. Cannot make any changes. |
Invitation — A time-limited invitation email sent to a new user. Invitations expire after 7 days. Expired invitations can be resent.
Session — Each user has independent sessions. Users are authenticated via Supabase JWT. Sessions expire after 24 hours of inactivity.
Getting Started
Navigate to Settings > Team.
To invite a new team member:
- Click Invite Member
- Enter their email address
- Select a role
- Click Send Invitation
The invitee receives an email with a link to create their account and join the tenant. If they already have a NexusCommerce account (from another tenant), they are added to this tenant directly.
Features
Team Members List
The team list shows all current members:
| Column | Description |
|---|---|
| Name | Display name (set by the user) |
| Account email address | |
| Role | Current role |
| Status | Active / Invited (pending) / Suspended |
| Last Active | Last login timestamp |
| Actions | Edit role / Remove / Suspend |
Role Management
Change Role — Click the role badge next to a member's name to open the role selector. Role changes take effect immediately on the user's next API request (the JWT is re-validated on each request).
Owner Transfer — An Owner can transfer ownership to another Admin by selecting "Promote to Owner" on their role card. This automatically downgrades the current Owner to Admin.
Pending Invitations
The Invitations tab shows all pending invitations:
- Invitee email
- Role assigned
- Sent date
- Expiry date
- Resend / Revoke actions
User Suspension
Suspended users cannot log in but their account and history are preserved. Use suspension rather than removal when a user is on temporary leave.
Click Suspend on a member's row, then Activate to reinstate.
Removing a Member
Click Remove to permanently revoke a user's access to the tenant. Their account in the auth system is preserved (they may still have access to other tenants), but all their access to this tenant's data is revoked.
All actions taken by the removed user (price changes, order fulfillments, etc.) remain in the audit log with their user ID preserved.
Configuration
| Setting | Description | Default |
|---|---|---|
| Invitation expiry | Days before an invitation link expires | 7 days |
| Session timeout | Hours of inactivity before session expires | 24 hours |
| SSO (Enterprise) | Configure SAML/OIDC single sign-on | Disabled |
| Allowed email domains | Restrict invitations to specific email domains | None (any domain) |