Skip to main content

Delete Team

Remove a team from the system. This action cannot be undone.

Required Permissions​

teams

Overview​

Deleting a team permanently removes it from the system along with all team-client associations. This action cannot be undone, so it should be used carefully and only when a team is no longer needed.

Important Warning

Deleting a team will:

  • Remove all client assignments from the team
  • Permanently delete the team record
  • Remove team from all reports and statistics
  • Cannot be undone

Consider using the "Inactive" status instead of deletion to preserve historical data.

When to Delete vs. Deactivate​

Delete Team When:​

  • Team was created by mistake
  • Team is no longer relevant and won't be needed
  • You want to completely remove all traces of the team
  • Team has no historical value

Deactivate Team When:​

  • Team is temporarily not needed but may be used again
  • You want to preserve historical data and reports
  • Team has served its purpose but you want to keep records
  • You're unsure about future team needs

Accessing Team Deletion​

Method 1: From Team Details Page​

  1. Navigate to the team details page for the team you want to delete.
  2. Click the Delete Team button in the top-right corner.
  3. Confirm the deletion in the warning dialog.

Method 2: From Teams List Page​

  1. From the main navigation, click on the Teams menu item.
  2. Locate the team you want to delete.
  3. Click the dropdown menu (three dots) on the team card.
  4. Select Delete Team from the dropdown menu.
  5. Confirm the deletion in the warning dialog.

Deletion Process​

Step 1: Initiate Deletion​

  • Click the Delete Team button from either the team details page or teams list
  • A confirmation dialog will appear

Step 2: Confirmation Dialog​

The confirmation dialog will display:

  • Team Name: The name of the team being deleted
  • Client Count: Number of clients currently assigned to the team
  • Warning Message: Clear indication that this action cannot be undone
  • Confirmation Checkbox: Must be checked to proceed
  • Action Buttons: Cancel and Delete buttons

Step 3: Confirm Deletion​

  • Read the warning message carefully
  • Check the confirmation checkbox
  • Click the Delete button to proceed
  • Or click Cancel to abort the deletion

Step 4: Deletion Complete​

  • The team will be removed from the system
  • You'll be redirected to the Teams list page
  • A success message will confirm the deletion

Pre-Deletion Checklist​

Before deleting a team, consider:

Client Impact​

  • Are all clients assigned to other teams or do they need reassignment?
  • Have you notified clients about any changes to their team assignments?
  • Do you have a plan for managing the clients after team deletion?

Data Considerations​

  • Have you exported any important team data or reports?
  • Are there any historical records that reference this team?
  • Do you need to preserve team information for compliance purposes?

Business Impact​

  • Will deleting this team affect any ongoing processes?
  • Are there any dependencies on this team in other systems?
  • Have you consulted with other team members about the deletion?

Alternative Actions​

Before Deleting, Consider:​

Deactivating the Team​

  • Change team status to "Inactive"
  • Preserves all team data and client assignments
  • Can be reactivated later if needed
  • Maintains historical records

Reassigning Clients​

  • Move clients to other appropriate teams
  • Ensure all clients have proper team assignments
  • Update client management processes

Archiving Team Data​

  • Export team information and client lists
  • Save important team documentation
  • Preserve historical data for future reference

Recovery Options​

After Deletion​

  • Cannot be undone: The team and all its data are permanently removed
  • No recovery: There is no way to restore a deleted team
  • Recreate if needed: You can create a new team with the same name if needed

Data Loss​

  • Client assignments: All team-client relationships are lost
  • Team statistics: Historical team data is removed
  • Reports: Any reports referencing the team may be affected

Best Practices​

Before Deletion​

  1. Review team usage: Ensure the team is truly no longer needed
  2. Check dependencies: Look for any systems or processes that depend on the team
  3. Backup data: Export any important team information
  4. Notify stakeholders: Inform relevant team members about the deletion

During Deletion​

  1. Read warnings carefully: Pay attention to all confirmation messages
  2. Double-check selection: Ensure you're deleting the correct team
  3. Confirm intentionally: Only proceed if you're certain about the deletion

After Deletion​

  1. Verify completion: Check that the team no longer appears in the list
  2. Update processes: Modify any workflows that referenced the deleted team
  3. Communicate changes: Inform relevant parties about the team removal

Troubleshooting​

Common Issues​

Cannot Delete Team​

  • Permission Issues: Ensure you have teams deletion permissions
  • System Error: Try refreshing the page and attempting again
  • Network Issues: Check your internet connection

Deletion Failed​

  • Try Again: Refresh the page and attempt the deletion again
  • Check Permissions: Verify you have the required permissions
  • Contact Support: If the issue persists, contact technical support

After deleting a team, you may want to: