Deleting Contacts

Deleting contacts removes them permanently from your CRM. PloverCRM provides safeguards to prevent accidental deletion while making it easy to remove contacts when necessary.

---

Overview #

Contact deletion is used for:

• Removing duplicate contacts
• Cleaning up test data
• Complying with data deletion requests (GDPR, CCPA)
• Removing invalid or spam contacts
• Database maintenance

---

Important Warnings #

Permanent Deletion

⚠️ Critical: Deleted contacts cannot be recovered unless you have a backup.

What Gets Deleted:

• All contact information (standard and custom fields)
• All notes and activities
• List and tag assignments
• Contact ownership records
• Related metadata

What Remains:

• Form submissions (if tracked separately)
• Email campaign statistics (aggregated)
• Audit logs (if enabled)

Before Deleting

Always:

1. Export contact data as backup
2. Verify you’re deleting the correct contact
3. Check if contact has important notes
4. Consider archiving instead of deleting
5. Inform team members if shared contact

---

Deleting a Single Contact #

Method 1: From Contacts List

1. Navigate to PloverCRM → Contacts
2. Hover over the contact row
3. Click Trash (or Delete Permanently if already in trash)
4. Confirm deletion when prompted

Method 2: From Edit Screen

1. Open contact in edit mode
2. Click Move to Trash in the Publish metabox
3. Confirm deletion

Method 3: From Contact Detail Page

1. View contact detail page
2. Click Delete button
3. Confirm deletion when prompted

Confirmation Dialog

Are you sure you want to delete this contact?
Contact: John Doe ([email protected])
This action cannot be undone.

[Cancel] [Delete Permanently]

What to Check:

• Verify contact name and email
• Check for important notes
• Ensure no pending tasks
• Confirm it’s not a duplicate of the wrong contact

---

Trash vs Permanent Delete #

Two-Step Deletion (PloverCRM)

Step 1: Move to Trash

• Contact moved to trash
• Not permanently deleted yet
• Can be restored within 30 days
• Hidden from normal contact lists

Step 2: Permanent Delete

• After 30 days, auto-deleted
• Or manually delete from trash
• Cannot be recovered
• Completely removed from database

Viewing Trashed Contacts

1. Go to PloverCRM → Contacts
2. Click Trash link (above contact list)
3. View all trashed contacts
4. Restore or permanently delete

Restoring from Trash

1. Go to trash view
2. Hover over contact
3. Click Restore
4. Contact returns to active contacts

Emptying Trash

1. Go to trash view
2. Click Empty Trash button
3. Confirm permanent deletion
4. All trashed contacts deleted permanently

⚠️ Warning: This cannot be undone!

---

Bulk Deletion #

Delete multiple contacts at once. See Bulk Operations for details.

Quick Steps

1. Navigate to PloverCRM → Contacts
2. Select contacts using checkboxes
3. Choose Move to Trash from Bulk Actions
4. Click Apply
5. Confirm bulk deletion

Bulk Delete Limits

Safety Limits:

• Maximum 100 contacts per bulk operation
• Requires confirmation for > 10 contacts
• Super admin can override limits

For Larger Deletions:

• Use filters to narrow selection
• Delete in multiple batches
• Consider using WP-CLI for very large deletions

---

Permission Requirements #

Delete Permissions

Who Can Delete:

• Super admins (all contacts)
• Users with delete_contacts capability
• Contact owners (their own contacts, if permitted)

Permission Levels:

Scope	What They Can Delete
delete_scope = owned	Own contacts only; cannot delete unassigned or others’ contacts
delete_scope = all	Any contact, including unassigned and others’ contacts

Checking Delete Permission

Visual Indicators:

• “Trash” link visible = can delete
• No “Trash” link = no permission
• Grayed out = insufficient permission

Error Message:

"You do not have permission to delete this contact"

Solutions:

1. Contact administrator for permission
2. Ask contact owner to delete
3. Request role upgrade if needed

---

GDPR/CCPA Compliance #

Right to Erasure

GDPR Article 17 / CCPA Requirements

When a contact requests data deletion:

1. Verify identity of requester
2. Export contact data (for records)
3. Delete contact from CRM
4. Document deletion request
5. Confirm deletion to requester

Deletion Workflow

1. Receive Request: Email or form submission; verify identity
2. Export Data: Export contact as CSV, save to secure location, document export date
3. Delete Contact: Move to trash, permanently delete, clear from any caches
4. Verify Deletion: Search for contact (should not exist), check related systems, confirm complete removal
5. Document: Log deletion request, record deletion date, keep audit trail
6. Confirm: Email confirmation to requester, include deletion date, explain what was deleted

Retention Policies

Legal Requirements:

• Some data may need to be retained for legal/tax purposes
• Check local regulations
• Consult legal counsel

Best Practice:

• Document retention policy
• Automate deletion after retention period
• Regular compliance audits

---

Alternatives to Deletion #

Archiving Contacts

Instead of deleting, consider creating an “Archived” tag:

1. Create tag called “Archived”
2. Assign to contacts you want to hide
3. Filter out archived contacts in views
4. Can be restored easily

Benefits: Preserves data, can be restored, maintains history, complies with retention policies

Unsubscribing

For email-related removals:

FluentCRM: Change status to “Unsubscribed” — contact remains in database, won’t receive emails, can be resubscribed.

PloverCRM: Remove from all email lists, add “Unsubscribed” tag, keep contact data, can be re-added to lists.

Marking as Inactive

1. Create stage called “Inactive”
2. Move contacts to this stage
3. Filter out in reports
4. Preserves all data

---

Troubleshooting #

Cannot Delete Contact

Problem: Delete option not available or grayed out.

1. Check if you have delete permission
2. Verify contact ownership
3. Check delete_scope setting
4. Ensure you’re not trying to delete yourself
5. Contact administrator

Deletion Fails with Error

Problem: Error message when trying to delete.

1. Check server error logs
2. Verify database connection
3. Check for plugin conflicts
4. Try deleting from a different screen
5. Contact support with error details

Contact Still Appears After Deletion

Problem: Deleted contact still shows in lists.

1. Refresh the page
2. Clear browser cache
3. Check if in trash (not permanently deleted)
4. Verify deletion completed successfully
5. Check for caching plugins

Bulk Delete Fails

Problem: Bulk deletion doesn’t work or times out.

1. Reduce number of contacts selected
2. Delete in smaller batches
3. Check server timeout limits
4. Try individual deletions
5. Use WP-CLI for large deletions

Accidentally Deleted Contact

Problem: Deleted wrong contact by mistake.

1. Check trash immediately
2. Restore from trash if available
3. Restore from backup if permanently deleted
4. Re-create contact manually if no backup
5. Check audit logs for contact data

---

Best Practices #

Before Deleting

1. Verify Identity: Double-check contact name, verify email address, check for similar contacts
2. Export Data: Create backup, save important notes, document reason for deletion
3. Check Dependencies: Review notes and activities, check for pending tasks, verify no active campaigns
4. Team Communication: Notify team if shared contact, check if anyone needs the data, document deletion decision

During Deletion

1. Use Trash First: Move to trash before permanently deleting — allows a 30-day recovery window
2. Confirm Carefully: Read confirmation dialog, verify contact details, don’t rush through confirmation
3. Document Reason: Add a note before deleting if possible, log deletion reason, maintain audit trail

After Deletion

1. Verify Deletion: Search for contact (should not exist), check related lists, confirm complete removal
2. Update Records: Update any external systems, remove from email lists, clear from integrations
3. Maintain Compliance: Document deletion for GDPR/CCPA, keep audit logs, confirm to requester if applicable

---

Related Documentation #

• Creating Contacts Manually
• Editing Contact Details
• Bulk Operations
• Contact Ownership
• Roles and Permissions
• Exporting Contacts (CSV)

---

Need Help? #

If you’re having trouble deleting contacts:

1. Verify you have delete permission
2. Check contact ownership
3. Try moving to trash first
4. Review error logs
5. Contact support with specific error messages

---

Last updated: February 3, 2026