Purpose
The Contacts module is the central database where all company contacts and their relevant information are stored. Contact records track individuals or entities that can be linked to Clients, Vendors, or Subcontractors in the Directory. Contacts can also be toggled as Leads for the Jobs workflow, seamlessly connecting your prospect pipeline with your project management system.
List View
View and manage all active Contact records with powerful filtering and search tools
- Quick Search by contact name, company, or keywords
- Advanced Filter for multi-criteria searches
- Radius Filter to find contacts near specific locations
- Batch Actions for managing multiple contacts simultaneously
- Import/Export tools for bulk data management
Search Options
The Quick Search field allows you to rapidly find contacts by searching across multiple data points.
| Search By | Contact name, company name, or keywords assigned to the contact record |
| Search Behavior | Partial match - results appear as you type, filtering the contact list in real-time |
Standard filter buttons provide quick access to commonly used contact views.
| All | Displays all active Contact records in the system |
| My Records | Shows all Contact records assigned to your user account |
| Favorites | Displays any Contact records you have flagged as favorites |
| Archive | Shows Contact records marked as archived (hidden from active views) |
Advanced Filter allows searching using multiple different search criteria simultaneously, including contact details, assignment status, categories, and custom fields.
For complete instructions on using Advanced Filter, see the Advanced Filter guide.
Search for contacts within a specified radius of an address. This is particularly useful for finding nearby prospects, identifying contacts in a service area, or planning regional outreach campaigns.
| Search Method | Enter an address and specify a radius distance (in miles or kilometers) |
| Results | Displays all contacts with addresses within the specified geographic area |
Find records similar to a specified contact based on name, company, address, or other identifying characteristics. Useful for identifying potential duplicate records or finding related contacts.
Generate Reports
Select the PDF icon to generate available contact reports. Reports are based on your current filtered view.
| Basic | List of contacts with their basic information (name, company, phone, email) |
| Detailed | Comprehensive information for each contact including all custom fields and attributes |
Import / Export Records
Import multiple contacts simultaneously using a CSV template. Use the gear icon (⚙️) to download the CSV template, populate it with your contact data, and upload the completed document.
Tip: Review the template structure carefully before uploading. Ensure column headers match exactly and required fields are populated to avoid import errors.
Select the export icon to download a CSV file of contact records based on your current filtered view. The export includes all visible fields and can be opened in spreadsheet applications.
| Export Scope | Only contacts matching your current filter criteria will be exported |
| Permission Required | Export Contacts (ID #1558) |
Record Options
Select the menu icon (≡) on any contact record to access quick actions:
| Add as a favorite | Flag this contact for quick access via the Favorites filter |
| Perform a web search | Search for this contact's information online using your default browser |
| Find similar records | Search for contacts with similar names, companies, or addresses |
| Duplicate the contact | Create a copy of this contact record to use as a template |
| Omit from the current list | Temporarily hide this contact from the current filtered view |
| Print mailing labels | Generate printable mailing labels for this contact. Requires permission: Mailing Labels (ID #1344) |
Batch Actions
Perform actions on multiple contacts simultaneously by selecting checkboxes next to contact records, then choosing an action from the Batch Actions menu.
| Assign | Assign selected contacts to specific users for follow-up or management |
| Lead | Toggle selected contacts as Leads or remove Lead status in bulk |
| Stage | Update the stage for multiple contacts at once (requires contacts to be marked as Leads) |
| Category | Assign or change the category for multiple contacts simultaneously |
Selected Contact View
Detailed view of individual contact records with specialized modes and tools
When a Contact is selected from the list view, the Selected Record section displays detailed information organized across multiple modes: Overview, Details, and Marketing. Each mode provides specialized views and tools for managing different aspects of the contact's information.
Contact Modes
Overview Mode provides quick access to essential contact information and recent activity.
Contact Information
| Phone/Email/Address | Add and manage multiple phone numbers, email addresses, and physical addresses for the contact. Each can be designated as primary or secondary. |
Activity Log
| Activity Log | View and add recent activities, notes, or communications related to this contact. Automatically tracks system-generated activities such as stage changes and assignments. |
Details Mode contains comprehensive information about the contact including personal details, internal categorization, file management, and custom attributes.
Person Information
| Person | Enter and format the contact's full name (prefix, first name, middle name, last name, suffix) |
| Company | Enter the company name if this contact is associated with a business |
| Title | Enter the person's job title or role if applicable (e.g., "Project Manager", "Owner") |
Internal Management
| Keywords | Enter searchable keywords for categorization and quick retrieval (e.g., "architect", "repeat customer", "VIP") |
| Category | Assign a Category to the Contact record. Categories are configured in the Categories module and can be customized for your business needs. |
| Archive | Mark a contact for archiving. Archived contacts are hidden from active views but preserved in the database and can be restored. |
| Company Checkbox | Indicate if the contact represents a company rather than an individual. When enabled, the contact name is treated as a company name. |
Document Management
| Business Card | Upload an image of the contact's business card for quick reference |
| Files/Emails/Notes | Track and store related documents, captured emails, and notes associated with this contact. Files uploaded here are linked to the contact record and accessible across modules. |
Custom Data
| Attributes | Add available attributes to track additional custom data specific to your business needs. Attributes are configured in the Attributes module. |
Marketing Mode tracks lead-related information including marketing qualification, source attribution, and lead progression through your sales pipeline.
Marketing Qualification
| Marketing Qualified | Indicate if the contact meets your criteria for marketing outreach or sales engagement |
| Do Not Contact | Mark if the contact has requested not to receive marketing materials or communications. Respects opt-out preferences and compliance requirements. |
| Birthday | Set the contact's birthday for relationship building and personalized outreach |
Lead Tracking
| Origin Date | Date that the Contact record was created in the system. Automatically populated when the contact is first added. |
| Source | Assign the marketing source or channel where this Contact was acquired (e.g., "Website", "Referral", "Trade Show"). Sources are customizable in the Categories module. |
| Stage | Adjust the current sales stage of the Contact (e.g., "New Lead", "Qualified", "In Progress"). Stages are customizable in the Categories module and drive workflow automation. |
| Due | Set a due date for follow-up. This field is only available for contacts marked as Leads and creates reminder notifications. |
Assignment
| Assigned | Assign users to the contact record for ownership, follow-up, or collaboration. Multiple users can be assigned to a single contact. |
Additional Features
The Lead button allows you to toggle a contact on or off as a Lead for the Jobs workflow. When enabled, the contact appears in both the Contacts module and the Leads module with synchronized information.
| Toggle Behavior | Click to enable or disable Lead status. When enabled by default upon Lead creation, all Lead data automatically syncs with the Contact record. |
| Data Synchronization | Changes made in the Contact record immediately reflect in the Lead record and vice versa, maintaining a single source of truth. |
Note: When a contact is marked as a Lead, additional fields become available in Marketing Mode (Stage, Due Date, Source) and the contact appears in lead-specific workflows and reports.
The Actions button provides quick access to create related records and perform contact-specific operations.
| New | Quickly create new records in related modules with this contact pre-populated (Event, Schedule, Quote, Job, Client, Vendor, Subcontractor, etc.) |
| Link Contact | Link this Contact record to an existing Client, Vendor, or Subcontractor account. Once linked, the contact appears in the Contacts section of that account. |
| View the Contact as a Lead | Open the associated Lead record in the Leads module. This option is only available if the contact has the "Lead" toggle enabled. |
| Notify Contact | Send an email or text notification to this contact using TRUE's communication features. Text messages require the Messages package subscription. |
Frequently Asked Questions
Common questions and step-by-step guidance for working with Contacts
Contact Creation & Management
You can create new contacts manually or import multiple contacts at once using the CSV import feature.
To create a single contact manually:
- Navigate to Directory → Contacts
- Click the + (Plus) button at the top of the list view
- Enter the contact's name in the Person field
- Add phone numbers, email addresses, and physical addresses in the Overview mode
- Switch to Details mode to add company, title, keywords, and category
- Switch to Marketing mode to set source, stage, and assignment (if tracking as a lead)
- Click Save to create the contact record
Yes, TRUE supports bulk importing contacts using CSV files. Excel files (.xlsx) are not directly supported - you must use the CSV template provided by the system.
- Navigate to Directory → Contacts
- Click the Gear icon (⚙️) at the top of the list view
- Select CSV Template to download the required format
- Open the template and add your contact data, ensuring column headers remain unchanged
- Save your file as CSV format (not Excel .xlsx)
- Return to the Contacts module
- Click the Gear icon (⚙️) and select Import Records
- Upload your completed CSV file and review the import results
Important: The Import feature only accepts CSV files that match the exact column structure of the CSV Template. Always download a fresh template before importing to ensure you have the correct format for your TRUE system version.
Any contact can be converted to a Lead to track them through your sales pipeline. Once marked as a Lead, the contact appears in both the Contacts and Leads modules with synchronized data.
- Open the contact record you want to convert to a Lead
- Click the Lead button at the top of the contact record (it will toggle to "on" state)
- Switch to Marketing mode to set lead-specific fields:
- Stage: Set the current sales stage (e.g., "New Lead", "Qualified")
- Source: Identify where this lead originated (e.g., "Website", "Referral")
- Due Date: Set a follow-up date for this lead
- Assigned: Assign users responsible for following up
- The contact now appears in both Directory → Contacts and Jobs → Leads
Note: You can toggle the Lead status on or off at any time. Turning off Lead status hides the contact from the Leads module but preserves all marketing data.
Archiving and deleting serve different purposes for managing inactive or outdated contacts.
Archive (Recommended for most cases)
- Purpose: Hide inactive contacts from active views while preserving the complete record
- Data retention: All contact information, history, and relationships are preserved
- Reversible: Can be unarchived at any time to restore to active status
- Reporting: Archived contacts still appear in historical reports and maintain links to jobs, quotes, and other records
- How to archive: Open the contact → Details mode → check the Archive checkbox
- Access archived contacts: Use the Archive filter in list view
Delete (Use with caution)
- Purpose: Permanently remove a contact from the database
- Data retention: Contact is completely removed and cannot be recovered
- Irreversible: Deletion is permanent and cannot be undone
- Impact: May break links to related records and affect historical reporting
- Permission required: Delete Contacts (ID #639)
- When to use: Only for duplicate records or data entry errors
Best Practice: Use Archive instead of Delete for contacts you no longer actively work with. This preserves historical data integrity and maintains the ability to reference past relationships.
The Radius Filter allows you to find contacts within a specified distance of any address, perfect for planning regional outreach, identifying nearby prospects, or managing service territories.
- Navigate to Directory → Contacts
- Click the Radius Filter button in the search options area
- Enter the center address (street address, city, state, or ZIP code)
- Specify the search radius in miles or kilometers
- Click Search to display all contacts within that geographic area
Common use cases:
- Service area planning: Identify prospects within your coverage zones
- Regional campaigns: Find contacts near a specific jobsite for marketing outreach
- Territory management: Assign contacts to sales reps based on geographic proximity
- Event invitations: Find local contacts for trade shows, open houses, or community events
Note: Contacts must have a physical address entered to appear in radius search results. The system uses the primary address when multiple addresses are stored.
Assigning users to contacts establishes ownership and enables automated notifications for follow-ups, stage changes, and other lead activities.
To assign users to a single contact:
- Open the contact record
- Switch to Marketing mode
- Locate the Assigned field
- Select one or more users from the dropdown list
- Click Save to apply the assignment
To assign users to multiple contacts at once:
- In the Contacts list view, check the boxes next to contacts you want to assign
- Click the Batch Actions button
- Select Assign
- Choose the users you want to assign
- Click Apply to assign all selected contacts
Note: Assigned users automatically receive notifications when leads are due for follow-up or when the lead stage changes. Multiple users can be assigned to a single contact for team collaboration.
Linking contacts to account records connects individuals to their organizations, making it easier to manage business relationships and access all contacts associated with a specific company.
- Open the contact record you want to link
- Click the Actions button at the top of the contact view
- Select Link Contact
- Choose the account type (Client, Vendor, or Subcontractor)
- Search for and select the existing account record
- Confirm the link to establish the relationship
Benefits of linking contacts:
- Contact appears in the Contacts section of the linked account record
- Quickly access all individuals associated with a company
- Maintain organizational hierarchy (company → multiple contacts)
- Streamline communication by selecting from all contacts at an account
Note: A single contact can be linked to multiple accounts. For example, a consultant might be linked to both a Client account and a Subcontractor account if they wear both hats.
Advanced Features
TRUE's Quick Search field provides two powerful search capabilities: Local Search within the current module and Global Search across all modules.
Available in List View Quick Search:
- Contact Name: Search by person's name (first or last)
- Company Name: Search by company or business name
- Keywords: Search keywords assigned to contact records
How to use:
- Type your search term in the Quick Search field at the top of the list
- Results filter in real-time as you type
- Press Enter or click a result to select that contact
Global Search lets you search across different categories of records throughout the entire TRUE system, not just contacts.
How to access Global Search:
- Click in the Quick Search field
- Look for the category tabs that appear (Phone/Email/Address, Client/Vendor, Contact/Lead, etc.)
- Click the category where you want to search (e.g., Phone / Email / Address)
Global Search Categories Available:
- Phone / Email / Address: Search contact information including addresses
- Client / Vendor: Search company and business names
- Contact / Lead: Search individual contact records
- Quote: Search quote records
- Job: Search job records by various fields
- Bid: Search bid records
- Contract: Search contract records
- Tickets: Search work tickets
- Vehicles: Search vehicle fleet records
- Tools: Search tool and equipment inventory
- Personnel: Search employee records
- Products / Services: Search catalog items
- Inventory: Search inventory stock items
- Purchase Orders: Search purchasing records
Tip: Global Search is especially useful when you don't know which module a record is in, or when you want to find all records related to a specific phone number, email, or address across the entire system.
Configuration & Administration
Access to the Contacts module is controlled by user permissions. If you cannot see or access this module:
- Contact your system administrator
- Request the Module Access (Contacts) permission (ID #33)
- Once granted, you'll find the module in the Directory workflow
Note: Administrators can manage permissions in Settings → Users / Access → select user → Access tab.
The ability to permanently delete contacts requires a specific security permission. If you cannot delete contacts:
- Contact your system administrator
- Request the Delete Contacts permission (ID #639)
- This permission is found in the Contacts section of user access settings
Reminder: Consider using the Archive feature instead of deleting contacts. Archiving preserves historical data while removing contacts from active views.
The ability to export contact lists requires a specific security permission. If you cannot export contacts:
- Contact your system administrator
- Request the Export Contacts permission (ID #1558)
- This permission is found in the Contacts section of user access settings
The ability to generate mailing labels requires a specific security permission. If you cannot print mailing labels:
- Contact your system administrator
- Request the Mailing Labels permission (ID #1344)
- This permission is found in the Contacts section of user access settings
The ability to modify contact ID numbers requires a specific security permission. If you cannot change contact IDs:
- Contact your system administrator
- Request the Modify ID (Contacts) permission (ID #1002)
- This permission is found in the Contacts section of user access settings
Note: Contact IDs are typically auto-generated by the system. Only modify IDs when migrating data from another system or when maintaining a specific numbering convention.
Address and phone searches are not available in the Contacts list view Quick Search for performance reasons. Use the global Search feature instead.
To search by address, phone, or email:
- Click the Workflow icon in the top navigation bar
- Select Search
- Enter your search term (address, phone number, or email)
- Click Phone / Email / Address to search across all records
- Or click Contact / Lead to search only within contact and lead records
Tip: The global Search feature also lets you search by Client/Vendor, and across specific modules like Jobs, Quotes, Bids, Contracts, Invoices, Bills, and more.