contacts-help • Documentation
Contacts Help
How contacts-help works
This page explains the full flow for managing contacts: adding a new contact, searching by email, updating details, and removing contacts. Use this as a user guide or as product documentation.
Key actions
- Add a contact with required fields
- Search a contact by email
- Edit contact data (name, phone, company)
- Remove a contact
Recommended data
- Name (required)
- Email (required, unique)
- Company (optional)
- Phone (optional)
Process summary
1
Add Contact
Create a new contact and validate required fields (name + email).
2
Search by Email
Find an existing contact using the email address as the primary key.
3
Edit & Remove
Update contact fields or delete the contact if needed.
Tip
Use email as a unique identifier to prevent duplicates and make searches faster.
Add Contact
Steps to add a new contact to your contacts list.
Steps
1
Open “Add Contact”
Navigate to contacts-help and choose the option to add a contact.
2
Enter required fields
Fill out Name and Email. Email should be unique.
3
Optional information
Add Company and Phone if available.
4
Save
Submit the form. The system should confirm success or show validation errors.
Validation rules (suggested)
- Name is required
- Email is required and must be a valid email format
- Email must be unique (no duplicates)
- Phone is optional (if provided, should be valid)
Search by Email
Use the email address to find a contact. This is typically the fastest and most reliable search method.
Steps
1
Enter the email
Type the email in the search input.
2
Run search
Press the search button or hit Enter.
3
Review results
If found, show the contact details. If not, show a clear “not found” state.
Interactive demo (UI only)
This is a front-end example to show how a search result could look.
Result
Name
—
Email
—
Company
—
Phone
—
Status
—
Not found experience
- Show a message: “No contact found for this email.”
- Provide an action: “Add Contact” with the email pre-filled.
- Suggest checking typos or alternative emails.
Edit & Remove
How to update contact details and how to remove a contact.
Edit contact
1
Find the contact
Search by email or locate the contact in your list.
2
Open edit mode
Click “Edit” to enable changes.
3
Update fields
Modify name, company, or phone. Email edits should be handled carefully to keep uniqueness.
4
Save changes
Confirm updates and show a success message.
Remove contact
1
Select the contact
Open the contact detail view.
2
Click “Remove”
Prompt a confirmation dialog to prevent accidental deletions.
3
Confirm deletion
Delete the contact and show feedback that it was removed.
Best practice
If your system supports audit logs, record who edited or deleted a contact and when it happened.
Troubleshooting
Common issues when adding or searching contacts and how to handle them.
Common issues
Duplicate email
- Show: “This email already exists.”
- Offer: “Open existing contact” action.
Invalid email format
- Validate on blur and on submit.
- Show a short hint under the field.
Contact not found
- Show a clear empty state.
- Offer: add a new contact with the searched email.
Network/server error
- Show a retry button.
- Log error details for debugging.
Suggested UX messages
- “Contact created successfully.”
- “Changes saved.”
- “No contact found for this email.”
- “Something went wrong. Please try again.”