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 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 #

Warning Message:

<span class="hljs-selector-tag">Are</span> <span class="hljs-selector-tag">you</span> <span class="hljs-selector-tag">sure</span> <span class="hljs-selector-tag">you</span> <span class="hljs-selector-tag">want</span> <span class="hljs-selector-tag">to</span> <span class="hljs-selector-tag">delete</span> <span class="hljs-selector-tag">this</span> <span class="hljs-selector-tag">contact</span>?

<span class="hljs-selector-tag">Contact</span>: <span class="hljs-selector-tag">John</span> <span class="hljs-selector-tag">Doe</span> (john<span class="hljs-variable">@example</span>.com)
<span class="hljs-selector-tag">This</span> <span class="hljs-selector-tag">action</span> <span class="hljs-selector-tag">cannot</span> <span class="hljs-selector-tag">be</span> <span class="hljs-selector-tag">undone</span>.

<span class="hljs-selector-attr">[Cancel]</span> <span class="hljs-selector-attr">[Delete Permanently]</span>

What to Check:

• Verify contact name and email
• Check for important notes
• Ensure no pending tasks
• Confirm it’s not a duplicate of 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 #

Empty All:

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:

delete_scope = owned:

• Can only delete own contacts
• Cannot delete unassigned contacts
• Cannot delete others’ contacts

delete_scope = all:

• Can delete any contact
• Can delete unassigned contacts
• Can delete others’ contacts

Checking Delete Permission #

Visual Indicators:

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

Error Message:

"You <span class="hljs-keyword">do</span> <span class="hljs-keyword">not</span> have permission <span class="hljs-keyword">to</span> <span class="hljs-keyword">delete</span> this contact<span class="hljs-string">"</span>

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 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 #

Step-by-Step:

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:

Create “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 #

Create “Inactive” Stage:

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.

Solutions:

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.

Solutions:

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

Contact Still Appears After Deletion #

Problem: Deleted contact still shows in lists.

Solutions:

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.

Solutions:

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.

Solutions:

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, don’t permanently delete immediately
   • Allows 30-day recovery window
   • Safer than immediate permanent deletion
2. Confirm Carefully:
   • Read confirmation dialog
   • Verify contact details
   • Don’t rush through confirmation
3. Document Reason:
   • Add 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 – Creating contacts
• Editing Contact Details – Updating contacts
• Bulk Operations – Bulk deletion
• Contact Ownership – Ownership system
• Roles and Permissions – Permission system
• Exporting Contacts (CSV) – Backup before deletion

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