Purpose

The Clients module allows users to organize and track all client accounts, manage billing and receivables, and generate comprehensive reports. Users can easily filter, sort, and view client accounts by balance, receivables, and past due status at a glance. This module serves as the central hub for client account management and integrates with Quotes, Jobs, Contracts, Invoices, and payment processing systems.

Account Management
Contact info, billing, terms, and status
A/R Tracking
Monitor receivables and past due accounts
Comprehensive Reports
Statements, balances, warranties, labor
Import/Export
Bulk CSV import and data export
Cross-Module Display
Also appear in Vendors or Subcontractors
Stripe Integration
Manage payment methods and process payments

List View

View and manage all active Client records with powerful filtering and reporting tools

  • Button Bar Filters: Quickly filter by All Clients, Favorites, Receivables, Past Due, or Account Hold status
  • Search Options: Find clients by name, address, balance, or advanced filter criteria
  • Comprehensive Reports: Generate 10 different reports including statements, balances, A/R audit history, and labor hours
  • Import/Export: Bulk manage client records using CSV import templates and export functionality
  • Record Actions: Favorite clients, generate email capture codes, and manage individual records from the list

Button Bar

The button bar displays filtering options for viewing client accounts by status and type.

Clients Shows total number of active client account records
Favorites Filters records marked as favorites by the logged-in user
Receivables Filters clients with unpaid pay applications or invoices across all jobs and contracts
Past Due Filters client accounts currently past due on invoice payment
Account Hold Filters client account records marked on hold

Search Options

Field Description
Quick Search Search by client account name, address, or balance
Advanced Filter Provides additional filtering options
Archive Filter Filters all archived client records
Column Sorting Sort by selecting column headers (ascending or descending alphabetically)

Generate Reports

Select the PDF icon to generate the following reports:

Report Description
Basic List of clients with their contact information
Detailed Comprehensive information for each client on a separate page
A/R Applied Audit History Comprehensive list relating to the history of everything that has been produced by this Client
Balances Current balance for each client
Top Clients List of clients with the most sales
Warranties List of clients with warranties, descriptions, and expiration dates
Equipment List of all equipment for all clients, including serial numbers, dates, and images
Labor Hours Total labor hours incurred for all jobs, contracts, and work tickets per client for a specified date range
Win/Loss Ratio Displays total quotes, bids, jobs, contracts and the win/loss ratio per client
Statements All statements for a specified time period for all clients

Import / Export

Import Use the "⚙️" icon to download the import template and upload completed documents
Export Select the export icon to download a CSV file of client records

Record Options & Actions

Select the ≡ icon on a record to access these options:

Favorite Add the client as a favorite
Email Capture Generate an email capture code for the Client record
Omit Remove this record from the current found set of data
Delete Permanently delete this client record
Overdue Warranties Displays Client records with overdue warranties
Overdue Equipment Displays Client records with past due Equipment rentals
CSV Template Blank Export of the Client related fields, used for importing data
Import Records Import records from TRUE provided CSV file

Selected Client View

Detailed view of individual client records with specialized modes and comprehensive tracking

When a Client is selected from the list view, the Selected Client section displays detailed information organized across multiple modes: Overview, Details, Contacts, Warranties, Equipment, Labor, and Credits. Each mode provides specialized views and tools for managing different aspects of the client relationship.

Client Record Modes

Displays basic client information and account status with comprehensive tracking of quotes, bids, jobs, contracts, invoices, pay requests, and labor attributed to each client.

Button Label Description
Quotes Displays active Quote records related to Client
Bids Displays active Bid records related to Client
Jobs Displays active Job records related to Client
Contracts Displays active Contract records related to Client
Invoices Displays active Invoice records related to Client
Pay Requests Displays active Pay Request records related to Client

Contains detailed client information, billing settings, tax information, and internal notes.

ID System generated ID. Modifiable in Company Preferences
Tax ID Vendor/Client TEIN Number
Payment Terms Default set of Terms used when any Quote, Job
Delivery Instructions Customizable field for specific instructions to appear in a Job linked to the selected Client record
External ID Customizable field for users that manage another system outside of TRUE that need another layer of identifiable criteria
Resale Certification # Official ID number indicating the purchaser intends to resell goods
Shipping ID Displays the default shipping ID for the client record
Resale Certification Expiration Expiration date of the resale certification for this client
NOC Notice of Commencement threshold - This field is set with a dollar amount. When a customer is assigned to a quote or job, or a quote or job is created from a customer record, the user is prompted letting them know that an NOC is required for amounts over the threshold, and two attributes are added to the quote / job: "NTO" with a value of "Required", and "NOC" with a value of "Required"
% Discount Default percentage applied to every Job/Invoice created for the linked Client
QuickBooks ID Displays the linked QuickBooks ID for the Client record
Tax Rate Displays the default Tax Rate for the Client record
Class Default "Class" assigned to Client
Stripe Customer ID When linked to Stripe, this is an identifying criteria TRUE receives from Stripe that is assigned by Stripe for each Client
Tax Exemption Official ID linked to the Client confirming tax exemption status
Standing Customizable field to identify the linked Client's credit status
Client Instructions Customizable field for specific instructions to appear in a Job linked to the selected Client record
Tax Exemption Expiration Date of expiration for tax exemption certificate. This must be manually entered
Type Assign a "Type" to the Client record. Can be modified in the Categories module
Credit Limit Maximum total dollar amounts for total Jobs per the selected Client when the 'Credit Limit Check' checkbox is initiated in Company Preferences
Finance Charge Default additional finance charge that will be added to any Invoice for the linked Client
Pricing Code Assign a default Pricing Code for this client. When used, the pricing record that contains this pricing code will be used. Can be assigned to pricing records for products in the Products/Services module

Manage contacts associated with the client account. Set default Contacts, or delete existing associated Contacts.

Track and manage warranties for the client. Create a Warranty via a Job or Contract record.

List and manage equipment associated with the client.

View and manage labor hours attributed to the client. Tracked through time punches in records associated with this Client.

Manage credits associated with the client account.

Additional Features & Options

Modify the client account details, including the option to archive the account.

Account Name Displays the Client name
Account Hold Mark client accounts as on hold
Nickname Create a unique, commonly used display name for the Client
Archive Archive the selected Client record. Select again to remove from Archive
Email Client records associated primary email account
Generic Toggle to set the Client as a "Generic" account. Used for cash accounts where payment information is not stored
Phone Displays the clients primary contact phone number
Keywords Enter any relevant keywords used to identify this Client. Keywords can be used to perform a search in the list view for this client
Date Opened Display the date the Client record was created
Billing Address Displays the associated Billing address for the Client. Used for Invoicing
Shipping/Location Address Displays the associated Shipping/Jobsite address for the client
Done Save changes made to the Client record
Clients Toggle record as a "Client" record
Vendors Toggle record as a "Vendor" record
Subcontractors Toggle record as a "Subcontractor" record
Batch Actions Perform actions on multiple clients simultaneously (Omit, Delete)
Actions Button Quickly create new contacts, clients, vendors, or subcontractor accounts
Show All Counts/Show Active Counts Enable the button actions in the Overview mode to display both Active and Archived records. Select again to disable
↻ button Refresh the button counts
Favorite Add this Client record as a Favorite
Update Journal Entries When selected, this will update Journal Entries to use/update the selected Client. Typically users select this option when they have changed the name of the Client midway through the project lifecycle
Merge Perform a search through the system for duplicate Client records to automatically combine
Stripe Account Manager Opens the associated Stripe account for the selected Client. Users can add or remove stored payment information
Delete Permanently delete the selected Client record
Cross-module Display Option to display client accounts in Vendors or Subcontractors modules

Frequently Asked Questions

Common questions and step-by-step guidance for working with Clients

Account Creation & Management

Client records can be created through workflow conversion or directly via the Client field in any module. The method you use depends on your workflow (Jobs vs Contracts) and whether the client is new or existing.

For users following the Jobs workflow (service/residential work): When converting a Lead to a Quote, the system prompts you to handle the client record. This is the most common way new clients enter the system for service-based businesses.

  1. Select the Lead record in the Leads module
  2. Click the New button and select Quote
  3. Choose how to handle the client record:
    • New: Create a new client using the lead's contact information (most common for first-time customers)
    • Existing: Select an existing client if this lead is for a returning customer
    • Skip: Skip client selection now and assign the client later on the Quote
  4. Complete the Quote conversion - client record is created automatically if "New" was selected

Access the Client field via the edit card in any module to create or select clients. This method works for both Jobs and Contracts workflows.

Access the Client field:

  • Quotes/Jobs: OptionsEdit → click the pencil icon next to Client field
  • Bids: Select Bid → OptionsEdit → click the pencil icon next to Client field
  • Contracts: Setup button → click the pencil icon next to Client field

Create a new client:

  1. From the client selector, choose New Client
  2. Enter the Account Name (required)
  3. Fill in contact details including Email, Phone, and Billing Address
  4. Set Payment Terms, Tax Rate, and any applicable defaults
  5. Click Done to save the new client account

For standalone client creation without an associated lead, quote, or contract:

  1. Navigate to DirectoryClients
  2. Click the + button or Actions menu
  3. Enter the Account Name (required)
  4. Fill in contact details and billing information
  5. Click Done to save the new client account

Note: Creating clients directly is useful for setting up accounts before sales activity begins, or for non-sales client records.

Yes, TRUE supports bulk importing of client records using CSV files. This is ideal for migrating from another system or adding multiple accounts at once.

  1. Navigate to DirectoryClients
  2. Click the ⚙️ gear icon in the list view
  3. Select CSV Template to download the blank import template
  4. Fill in client information in the template using the correct column headers
  5. Return to the ⚙️ gear icon and select Import Records
  6. Upload your completed CSV file and review the import results

Tip: Review the CSV template carefully before importing to ensure all required fields are included and formatted correctly. Test with a small batch first before importing large datasets.

Archiving and deleting serve different purposes for managing inactive client accounts.

Archiving a Client

  • Hides the client from active lists while preserving all data and relationships
  • Maintains historical records, invoices, jobs, and contracts
  • Can be un-archived at any time to restore full visibility
  • Recommended for clients who are no longer active but may need future reference

Deleting a Client

  • Permanently removes the client record from the system
  • May impact historical reports and data integrity
  • Cannot be undone once deleted
  • Only recommended for duplicate or test records

Best Practice: Use archiving instead of deleting for any client with associated transactions, jobs, or contracts. This preserves historical data and reporting accuracy.

Account Status & Receivables

Use the Past Due button bar filter to quickly identify clients with overdue invoices.

  1. Navigate to DirectoryClients
  2. Click the Past Due button in the button bar at the top of the screen
  3. Review the filtered list showing only clients currently past due on invoice payment

Note: The count next to the Past Due button indicates the total number of clients with past due invoices. Use the Statements report to generate detailed aging information for collections follow-up.

Use the Account Hold feature to flag clients who should not receive new work or services until resolved.

  1. Navigate to DirectoryClients
  2. Select the client you want to place on hold
  3. Click OptionsEdit Card
  4. Check the Account Hold checkbox
  5. Click Done to save

Tip: Use the Account Hold button bar filter to view all clients currently on hold. This helps prevent accidentally creating new quotes or jobs for clients with account issues.

The Receivables button bar filter displays all clients with outstanding unpaid invoices or pay applications across all jobs and contracts, regardless of whether they're past due.

  1. Navigate to DirectoryClients
  2. Click the Receivables button in the button bar
  3. Review the filtered list of all clients with unpaid amounts

Note: The Receivables filter shows all clients with open balances, while Past Due specifically shows only those with invoices beyond their payment terms. Use the Balances report for detailed financial information.

Reports & Statements

Generate client statements for specified time periods to provide detailed billing and payment history.

  1. Navigate to DirectoryClients
  2. Click the PDF icon in the list view
  3. Select Statements from the reports menu
  4. Specify the time period for the statements
  5. Choose whether to generate for all clients or specific filtered clients
  6. Click Generate to create the PDF statements

Note: Filter the client list before generating statements to create statements for specific groups (e.g., only Past Due clients or Receivables).

Use the Labor Hours report to view total labor hours incurred for all jobs, contracts, and work tickets per client.

  1. Navigate to DirectoryClients
  2. Click the PDF icon in the list view
  3. Select Labor Hours from the reports menu
  4. Specify the date range for labor tracking
  5. Generate the report to see labor hours broken down by client

Note: Labor hours are tracked through time punches in the selected Client's associated jobs, contracts, and work tickets. This report provides valuable insights for billing, capacity planning, and client profitability analysis.

The Win/Loss Ratio report displays total quotes, bids, jobs, contracts and the win/loss ratio per client, helping you analyze sales effectiveness and client relationships.

  1. Navigate to DirectoryClients
  2. Click the PDF icon in the list view
  3. Select Win/Loss Ratio from the reports menu
  4. Review the report showing conversion rates and sales performance per client

Tip: Use this report to identify high-value clients with good conversion rates versus clients who request many quotes but rarely convert to jobs. This data can inform sales strategy and resource allocation.

Advanced Features

The Cross-module Display feature allows a single account to appear in multiple modules (Clients, Vendors, or Subcontractors) for companies that have multi-role relationships with the same entity.

  1. Navigate to DirectoryClients
  2. Select the client you want to display in other modules
  3. Click OptionsEdit Card
  4. Toggle Vendors or Subcontractors checkbox to enable cross-module display
  5. Click Done to save

Example Use Case: A construction company might be both a client (you build projects for them) and a vendor (you purchase materials from them). Enabling cross-module display allows the account to appear in both Clients and Vendors modules while maintaining a single record.

The Stripe Account Manager feature allows you to manage stored payment methods and process payments for clients when Stripe integration is enabled.

  1. Navigate to DirectoryClients
  2. Select the client whose payment methods you want to manage
  3. Click Stripe Account Manager
  4. Add, remove, or update stored payment information
  5. The Stripe Customer ID will be automatically assigned and displayed in the Details Mode

Note: Stripe integration must be configured in Company Preferences before the Stripe Account Manager feature becomes available. Once configured, you can securely store and manage client payment methods for faster payment processing.

Use the Merge feature to automatically identify and combine duplicate client records while preserving all associated transactions and history.

  1. Navigate to DirectoryClients
  2. Select the primary client record (the one you want to keep)
  3. Click the Merge button
  4. The system will perform a search for potential duplicate Client records
  5. Review the suggested duplicates and select which records to merge
  6. Confirm the merge to automatically combine the records

Important: The merge process combines all quotes, jobs, contracts, invoices, and historical data from the duplicate record into the primary record. Review carefully before confirming as this action cannot be easily undone.

Use the Update Journal Entries feature when you've changed a Client's name midway through the project lifecycle and need to update previously posted accounting entries.

  1. Navigate to DirectoryClients
  2. Select the client whose name was changed
  3. Click Update Journal Entries
  4. The system will update all previously posted journal entries to reflect the new client name

Note: This feature ensures consistency in financial reporting and prevents confusion when client names change due to business acquisitions, rebranding, or corrections to misspelled names.

Configuration & Administration

Access to the Clients module is controlled by user permissions. If you cannot see or access this module:

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

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

Several security permissions control specific actions within the Clients module:

Key Permissions

  • Delete (Clients / Vendors / Subcontractors) (ID #612) - User can delete Client records
  • Merge Clients / Vendors / Subcontractors (ID #1647) - User can merge duplicate records
  • Update Journal Entries (ID #1648) - User can update previously posted journal entries based on name changes
  • Modify Client / Vendor / Subcontractor Account Hold (ID #1561) - User can modify Account Hold status
  • Export (Clients / Vendors / Subcontractors) (ID #1560) - User can export records to Excel
  • View "Details" Mode (ID #566) - User can view and edit financial data for clients

Note: Contact your administrator to request specific permissions. Administrators configure these in SettingsUsers / AccessAccess tab → General or Clients sections.

Enable alert notifications to receive reminders when equipment installed for clients is due for follow-up.

  1. Navigate to SettingsUsers / Access
  2. Select the user who should receive alerts
  3. Go to the Access tab
  4. Find the Clients section
  5. Enable Alert when Client Equipment Follow-Ups are Due (ID #1503)

Tip: This alert is particularly useful for service-based businesses that install equipment and need to schedule regular maintenance or follow-up visits.