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.

Central Database
Store phone, email, address, and custom attributes
Lead Integration
Toggle contacts as Leads for sales pipeline
Account Linking
Connect to Clients, Vendors, Subcontractors
Radius Search
Find contacts near specific locations
Import/Export
Bulk import via CSV or export filtered lists
Marketing Mode
Track sources, stages, and DNC preferences

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:

  1. Navigate to DirectoryContacts
  2. Click the + (Plus) button at the top of the list view
  3. Enter the contact's name in the Person field
  4. Add phone numbers, email addresses, and physical addresses in the Overview mode
  5. Switch to Details mode to add company, title, keywords, and category
  6. Switch to Marketing mode to set source, stage, and assignment (if tracking as a lead)
  7. 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.

  1. Navigate to DirectoryContacts
  2. Click the Gear icon (⚙️) at the top of the list view
  3. Select CSV Template to download the required format
  4. Open the template and add your contact data, ensuring column headers remain unchanged
  5. Save your file as CSV format (not Excel .xlsx)
  6. Return to the Contacts module
  7. Click the Gear icon (⚙️) and select Import Records
  8. 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.

  1. Open the contact record you want to convert to a Lead
  2. Click the Lead button at the top of the contact record (it will toggle to "on" state)
  3. 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
  4. 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.

  1. Navigate to DirectoryContacts
  2. Click the Radius Filter button in the search options area
  3. Enter the center address (street address, city, state, or ZIP code)
  4. Specify the search radius in miles or kilometers
  5. 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:

  1. Open the contact record
  2. Switch to Marketing mode
  3. Locate the Assigned field
  4. Select one or more users from the dropdown list
  5. Click Save to apply the assignment

To assign users to multiple contacts at once:

  1. In the Contacts list view, check the boxes next to contacts you want to assign
  2. Click the Batch Actions button
  3. Select Assign
  4. Choose the users you want to assign
  5. 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.

  1. Open the contact record you want to link
  2. Click the Actions button at the top of the contact view
  3. Select Link Contact
  4. Choose the account type (Client, Vendor, or Subcontractor)
  5. Search for and select the existing account record
  6. 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:

  1. Type your search term in the Quick Search field at the top of the list
  2. Results filter in real-time as you type
  3. 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:

  1. Click in the Quick Search field
  2. Look for the category tabs that appear (Phone/Email/Address, Client/Vendor, Contact/Lead, etc.)
  3. 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:

  1. Contact your system administrator
  2. Request the Module Access (Contacts) permission (ID #33)
  3. Once granted, you'll find the module in the Directory workflow

Note: Administrators can manage permissions in SettingsUsers / Access → select user → Access tab.

The ability to permanently delete contacts requires a specific security permission. If you cannot delete contacts:

  1. Contact your system administrator
  2. Request the Delete Contacts permission (ID #639)
  3. 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:

  1. Contact your system administrator
  2. Request the Export Contacts permission (ID #1558)
  3. 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:

  1. Contact your system administrator
  2. Request the Mailing Labels permission (ID #1344)
  3. 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:

  1. Contact your system administrator
  2. Request the Modify ID (Contacts) permission (ID #1002)
  3. 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:

  1. Click the Workflow icon in the top navigation bar
  2. Select Search
  3. Enter your search term (address, phone number, or email)
  4. Click Phone / Email / Address to search across all records
  5. 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.