Team Management in NSPEC
Team management in nSpec is the umbrella for everything related to the people on your inspection team — adding new staff, organizing them by office, marking supervisors, assigning roles, and removing access when someone leaves. This article ties together the four main pieces (Employees, Offices, Roles, Collaborators) and shows you how they fit into the day-to-day life of running a team.
The Pieces of Team Management
Section titled “The Pieces of Team Management”| Concept | What it is | Where to manage it |
|---|---|---|
| Employees | Internal staff who use nSpec — inspectors, supervisors, admins. Each employee has a sign-in account. | Sidebar → Employees |
| Offices | Physical locations of your organization. Each employee belongs to a primary office. | Sidebar → Offices |
| Roles | Named bundles of permissions assigned to employees. Roles control what each person can see and do. | Sidebar → Admin → Roles tab |
| Collaborators | External users (clients, contractors) with limited, scoped access. Not counted as employees. | Sidebar → Collaborators |
| Supervisor flag | A checkbox on each employee that lets them be assigned to projects/inspections as a supervisor and gives them access to the Employees screen. | Edit Employee modal |
Adding a New Team Member
Section titled “Adding a New Team Member”When someone joins your organization, here’s the typical onboarding flow:
Step 1: Prepare the prerequisites
Section titled “Step 1: Prepare the prerequisites”- Make sure the person’s office exists in the Offices screen. If not, create it first. See Managing Offices in nSpec.
- Make sure the role they need exists in the Admin → Roles tab. If you’re using only built-in roles, you can skip this. See Roles and Permissions.
Step 2: Create the employee
Section titled “Step 2: Create the employee”- Open the sidebar and click Employees
- Click the + button to open the Create Employee modal
- Fill in name, email, office, and any optional details
- If they’ll lead projects or inspections, check Is Supervisor
- Decide between SSO and non-SSO based on whether they have a Microsoft account on your tenant’s domain
- Click Save
See Managing Employees in nSpec for the full list of fields and what each one does.
Step 3: They get an invite email
Section titled “Step 3: They get an invite email”nSpec automatically sends an invitation to the email address you entered. The new employee clicks the link to either:
- SSO accounts — Authorize their Microsoft account with nSpec
- Non-SSO accounts — Set their initial password
If the email never arrives, open the Edit Employee modal and click Send Invite (or Set Password for non-SSO).
Step 4: Assign roles
Section titled “Step 4: Assign roles”- Open the Edit Employee modal for the new person
- Click Edit Roles
- Move the appropriate roles from the Available list to the Assigned list
- Save
The roles take effect on their next sign-in. If they’re already signed in, ask them to refresh or sign out and back in.
Marking a Supervisor
Section titled “Marking a Supervisor”Supervisors are employees who can lead projects and inspections, and who also have access to the Employees screen themselves.
- Open the Edit Employee modal
- Check the Is Supervisor checkbox
- Click Save
Supervisors will appear in the Supervisor dropdown when creating projects and inspections.
Moving Someone to a Different Office
Section titled “Moving Someone to a Different Office”- Open the Edit Employee modal
- Change the Office dropdown to the new office
- Optionally add the old office to Additional Offices if they still work from both
- Save
Removing Someone from the Team
Section titled “Removing Someone from the Team”When someone leaves the organization, you have two options:
Option 1 (recommended): Deactivate
Section titled “Option 1 (recommended): Deactivate”- Open the Edit Employee modal
- Uncheck Is Active
- Save
The employee can no longer sign in, but their record is preserved so historical inspections and reports keep their author info intact. You can reactivate them later if they come back.
Option 2: Delete
Section titled “Option 2: Delete”- Open the Edit Employee modal
- Click Delete at the bottom
- Confirm in the dialog
This permanently removes the employee record. Use this only when you’re confident you’ll never need their account again — and only after deactivating first to confirm nothing breaks.
Adding External Team Members
Section titled “Adding External Team Members”Subcontractors, client representatives, and other external stakeholders shouldn’t be added as employees. Instead, add them as Collaborators:
- Open the sidebar and click Collaborators
- Click + to add a new collaborator
- Fill in their contact info and select which clients/projects they need access to
- Click Save — nSpec sends them a confirmation email
See Managing Collaborators for the full collaborator workflow.
Best Practices
Section titled “Best Practices”- Set up offices and roles first. Before onboarding employees in bulk, make sure your offices and roles structure is in place. It’s much easier than reassigning everyone later.
- Use SSO when possible. SSO employees don’t need to remember a separate password and you don’t need to reset passwords for them.
- Review roles quarterly. Run through your employee list once a quarter to confirm roles still match each person’s responsibilities.
- Deactivate, don’t delete. Unless you have a specific reason to delete an employee record, deactivation is safer.
- Use Collaborators for external people. Don’t burn an employee seat on a contractor who only needs to read a few reports.