Editing Contact Details

PloverCRM offers multiple ways to update contact information: full edit screen, quick edit, bulk edit, mobile app, and REST API.

Prerequisites #

• update_contacts permission
• Contact ownership or appropriate view scope
• Field-level permissions

Full Edit Screen #

Accessing Full Edit #

1. From Contacts List: Hover over contact → Click Edit
2. From Contact Detail: Click Edit Contact button
3. Direct URL: /wp-admin/post.php?post=123&action=edit

Editing Fields #

Standard Fields: First Name, Last Name, Email, Phone, Address fields

Custom Fields: Appear in metaboxes by group (Business Info, Personal Details, Lead Info)

Lists & Tags: Right sidebar metaboxes

• Check/uncheck lists
• Type to add tags, click X to remove
• Create new tags inline

Stage: Select from dropdown in right sidebar

Owner: Select user or “Unassigned” (requires reassign permission)

Avatar: Set featured image (200x200px recommended, JPG/PNG/GIF, max 2MB)

Saving Changes #

• Click Update button (top/bottom)
• Keyboard: Ctrl+S (Win) or Cmd+S (Mac)
• Required fields marked with red asterisk (*)

Quick Edit #

Fast inline editing without opening full edit screen.

Using Quick Edit #

1. Hover over contact → Click Quick Edit
2. Edit fields in expanded row
3. Click Update Contact

Available Fields: First/Last Name, Email, Phone, City, State, Lists, Tags, Stage, Owner

Not Available: Custom fields, Notes, Full address, Avatar

Best For: Quick corrections, phone updates, list/tag changes, owner reassignment

Bulk Edit #

Edit multiple contacts simultaneously. See Bulk Operations for detailed guide.

Quick Overview:

1. Select multiple contacts (checkboxes)
2. Choose “Edit” from Bulk Actions dropdown
3. Select fields to update
4. Enter new values
5. Click Update

Bulk Editable Fields:

• Lists (add/remove)
• Tags (add/remove)
• Stage
• Owner
• Status (FluentCRM only)

Field-Level Permissions #

Your ability to edit fields depends on your role and permissions.

Viewing Edit Permissions #

Editable Fields:

• Normal appearance
• Can click and type
• Changes save successfully

Read-Only Fields:

• Grayed out or disabled
• Cannot modify
• May show lock icon

Hidden Fields:

• Not visible at all
• Completely restricted
• No indication field exists

Permission Levels #

Super Admin:

• Can edit all fields
• No restrictions
• Full access

CRM Manager:

• Can edit most fields
• May have restrictions on sensitive fields
• Cannot edit protected fields

CRM Agent:

• Can edit basic fields
• Limited custom field access
• Cannot edit ownership or advanced fields

Handling Permission Errors #

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">update</span> this <span class="hljs-keyword">field</span><span class="hljs-string">"</span>

Solutions:

1. Contact administrator for permission
2. Ask owner to make the change
3. Request role upgrade if needed
4. Use fields you have access to

Ownership-Based Editing #

Your ability to edit contacts depends on ownership and view scope.

Edit Permissions by Ownership #

Own Contacts:

• Can always edit (if you have update permission)
• Full access to all permitted fields
• Can reassign to others (if permitted)

Unassigned Contacts:

• Can edit if you have update_scope = all
• Can claim and then edit
• Limited if update_scope = owned

Others’ Contacts:

• Can edit only if update_scope = all
• Cannot edit if update_scope = owned
• Super admins can always edit

Checking Edit Permission #

Before Opening:

• “Edit” link visible = you can edit
• No “Edit” link = no permission

After Opening:

• Can modify fields = have permission
• Fields disabled = no permission
• Error on save = insufficient permission

Validation and Error Handling #

Required Field Validation #

Unique Identifier Field:

Cannot be empty:

<span class="hljs-keyword">Error: </span>"Email is required as it is configured as the unique identifier"

Solution: Enter valid value for required field.

Email Format Validation #

Invalid Email:

<span class="hljs-keyword">Error: </span>"Please provide a valid email address"

Valid Formats:

• [email protected] ✓
• [email protected] ✓

Invalid Formats:

• john@example ✗
• @example.com ✗

Duplicate Detection #

Changing Unique Identifier:

If you change email (or other unique identifier) to one that already exists:

PloverCRM:

• Updates the existing contact with that email
• Merges data
• Current contact may be deleted

FluentCRM:

• Shows error: “Email already exists”
• Prevents change
• Keeps original email

Best Practice: Search for existing contact before changing unique identifier.

Custom Field Validation #

Date Fields:

• Must be valid date format
• Example: 2026-02-03 or 02/03/2026

Number Fields:

• Must be numeric
• No letters or special characters

Select/Radio Fields:

• Must choose from available options
• Cannot enter custom values

URL Fields:

• Must be valid URL format
• Example: https://example.com

Best Practices #

Data Quality #

1. Keep Information Current:
   • Update when you learn new information
   • Verify details periodically
   • Remove outdated data
2. Use Consistent Formatting:
   • Phone: +1-555-0123 (with country code)
   • Names: Proper case (John Doe)
   • Addresses: Complete and accurate
3. Add Context with Notes:
   • Record why changes were made
   • Note source of new information
   • Track communication history

Workflow Efficiency #

1. Use Quick Edit for Simple Changes:
   • Faster than full edit screen
   • Perfect for single-field updates
   • Stays on contacts list
2. Use Full Edit for Comprehensive Updates:
   • Multiple field changes
   • Custom field updates
   • Adding notes
3. Use Bulk Edit for Multiple Contacts:
   • Same change to many contacts
   • Assigning lists/tags
   • Reassigning ownership

Change Tracking #

1. Add Notes When Making Significant Changes: Type: Note Title: Contact information updated Description: Updated phone <span class="hljs-built_in">number</span> <span class="hljs-keyword">and</span> company <span class="hljs-built_in">name</span> per email <span class="hljs-keyword">from</span> contact <span class="hljs-keyword">on</span> <span class="hljs-number">2026</span><span class="hljs-number">-02</span><span class="hljs-number">-03</span>
2. Review Contact History:
   • Check last modified date
   • Review notes for context
   • Understand contact journey
3. Coordinate with Team:
   • Communicate major changes
   • Avoid conflicting updates
   • Use notes for team visibility

Common Scenarios #

Scenario 1: Correcting Contact Information #

Situation: Contact emails with updated phone number.

Steps:

1. Search for contact by email
2. Click Quick Edit
3. Update phone number
4. Click Update Contact
5. Add note documenting change

Scenario 2: Promoting Lead to Customer #

Situation: Lead makes first purchase.

Steps:

1. Open contact in full edit
2. Change stage from “Lead” to “Customer”
3. Add to “Customers” list
4. Add “Active” tag
5. Update custom fields (purchase date, amount)
6. Add note with purchase details
7. Click Update

Scenario 3: Enriching Contact Data #

Situation: Research reveals additional information about contact.

Steps:

1. Open contact in full edit
2. Fill in missing custom fields
3. Update company information
4. Add relevant tags
5. Add note with information source
6. Click Update

Scenario 4: Bulk Updating List Assignment #

Situation: Need to add 50 contacts to new campaign list.

Steps:

1. Filter contacts by criteria
2. Select all 50 contacts
3. Choose “Edit” from Bulk Actions
4. Check new list
5. Click Update
6. Verify changes

Troubleshooting #

Cannot Save Changes #

Problem: Update button doesn’t work or changes don’t save.

Solutions:

1. Check for validation errors (red text)
2. Ensure required fields are filled
3. Verify you have update permission
4. Check browser console for errors
5. Try refreshing page and re-editing

Changes Revert After Saving #

Problem: Changes save but revert to old values.

Solutions:

1. Check if another user is editing simultaneously
2. Verify field permissions
3. Check for plugin conflicts
4. Review custom field validation rules
5. Check server error logs

Quick Edit Not Showing #

Problem: Quick Edit link doesn’t appear.

Solutions:

1. Verify you have update permission
2. Check ownership (may need update_scope = all)
3. Ensure contact is not locked
4. Try full edit instead
5. Check role permissions

Custom Fields Not Saving #

Problem: Custom field changes don’t persist.

Solutions:

1. Verify custom field exists and is active
2. Check field type validation
3. Ensure you have permission to edit field
4. Check for field-specific validation rules
5. Review error logs for specific issues

Mobile App Editing #

Edit contacts on-the-go with the PloverCRM mobile app:

Features:

• Edit all standard fields
• Update custom fields
• Change lists and tags
• Add notes
• Update stage
• Take photos for avatar

Sync:

• Changes sync immediately
• Offline edits sync when online
• Conflict resolution if edited on multiple devices

Related Documentation #

• Creating Contacts Manually – Creating contacts
• Understanding Contacts – Contact fundamentals
• Contact Fields Explained – All fields
• Custom Fields Overview – Custom fields
• Contact Ownership – Ownership system
• Bulk Operations – Bulk editing
• Roles and Permissions – Permission system

Need Help? #

If you’re having trouble editing contacts:

1. Verify you have update permission for the contact
2. Check field-level permissions
3. Review validation errors
4. Try different edit method (Quick Edit vs Full Edit)
5. Contact support with specific error messages

---

Last updated: February 3, 2026