How to Bulk-Delete Users in VICIdial Safely

Old seasonal hires, test accounts, a range you bulk-copied by mistake - sooner or later a VICIdial install collects logins nobody uses. Leaving them around is not just clutter; every stale account with a weak password is a small attack surface. User Bulk Delete clears them out in one pass instead of opening each account and removing it by hand.

How it works

You select the users to remove on a confirmation screen, and the tool deletes them from the system. It is the natural counterpart to bulk copy - whatever you create in a range, you can remove just as quickly with the same admin tool. If you have not used the create side yet, see how to bulk-copy a range of users. Because the two tools mirror each other, a predictable numbering scheme on the copy side pays off here: contiguous ranges are far easier to select for deletion.

Two guards that protect you

The tool refuses to delete two kinds of accounts, and both refusals are there to keep your system working:

• The account you are logged in as. You cannot delete yourself out of the admin interface mid-session, which would leave you locked out.
• Any user currently logged in as an Agent. An active Agent session is protected, so you will not yank an account out from under someone who is mid-call.

Both guards mean the tool quietly skips protected accounts rather than failing the whole batch, so you can run it confidently even during business hours.

Decide what gets deleted

flowchart TD
  A[Select users to delete] --> B{Is it your own login?}
  B -->|Yes| C[Blocked - skip]
  B -->|No| D{Logged in as an agent now?}
  D -->|Yes| E[Blocked - skip]
  D -->|No| F[Delete from system]
  F --> G[Historical reports remain]

A safe cleanup workflow

1. Check the real-time agent screen first - anyone live counts as an active Agent session and will be blocked anyway, but it is cleaner to know going in.
2. Confirm the Campaign each user touched is handled - historical stats stay, but you lose the convenient name lookup once the account is gone.
3. Delete test or stale accounts in small batches and review the user list after each batch.
4. Leave shared service accounts and your own admin login alone.

What deleting a user does not touch

Removing a user account does not delete the calls they handled or their place in historical reports - that data is keyed on the records, not on the live account, so your stats stay intact. It also does not touch phones. If you are decommissioning a whole team, you will want to clean up extensions separately; the Bulk Phone Insert page is the tool that created those, and the same admin section handles the wider picture in our admin bulk tools overview.

Treat bulk delete as routine hygiene rather than a once-a-year event. Clearing out departed agents promptly keeps your user list honest, shrinks the number of credentials anyone could misuse, and makes your real-time and historical screens easier to read because they only show people who still work there. A short monthly pass is usually enough to keep the list tidy without ever risking an active session.

On a managed box the admin panel and these safety guards are configured for you out of the gate. See VICIfast pricing for a server that ships ready to manage.