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.
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 |
| 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.
- Select the Lead record in the Leads module
- Click the New button and select Quote
- 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
- 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: Options → Edit → click the pencil icon next to Client field
- Bids: Select Bid → Options → Edit → click the pencil icon next to Client field
- Contracts: Setup button → click the pencil icon next to Client field
Create a new client:
- From the client selector, choose New Client
- Enter the Account Name (required)
- Fill in contact details including Email, Phone, and Billing Address
- Set Payment Terms, Tax Rate, and any applicable defaults
- Click Done to save the new client account
For standalone client creation without an associated lead, quote, or contract:
- Navigate to Directory → Clients
- Click the + button or Actions menu
- Enter the Account Name (required)
- Fill in contact details and billing information
- 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.
- Navigate to Directory → Clients
- Click the ⚙️ gear icon in the list view
- Select CSV Template to download the blank import template
- Fill in client information in the template using the correct column headers
- Return to the ⚙️ gear icon and select Import Records
- 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.
- Navigate to Directory → Clients
- Click the Past Due button in the button bar at the top of the screen
- 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.
- Navigate to Directory → Clients
- Select the client you want to place on hold
- Click Options → Edit Card
- Check the Account Hold checkbox
- 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.
- Navigate to Directory → Clients
- Click the Receivables button in the button bar
- 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.
- Navigate to Directory → Clients
- Click the PDF icon in the list view
- Select Statements from the reports menu
- Specify the time period for the statements
- Choose whether to generate for all clients or specific filtered clients
- 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.
- Navigate to Directory → Clients
- Click the PDF icon in the list view
- Select Labor Hours from the reports menu
- Specify the date range for labor tracking
- 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.
- Navigate to Directory → Clients
- Click the PDF icon in the list view
- Select Win/Loss Ratio from the reports menu
- 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.
- Navigate to Directory → Clients
- Select the client you want to display in other modules
- Click Options → Edit Card
- Toggle Vendors or Subcontractors checkbox to enable cross-module display
- 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.
- Navigate to Directory → Clients
- Select the client whose payment methods you want to manage
- Click Stripe Account Manager
- Add, remove, or update stored payment information
- 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.
- Navigate to Directory → Clients
- Select the primary client record (the one you want to keep)
- Click the Merge button
- The system will perform a search for potential duplicate Client records
- Review the suggested duplicates and select which records to merge
- 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.
- Navigate to Directory → Clients
- Select the client whose name was changed
- Click Update Journal Entries
- 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:
- Contact your system administrator
- Request the Module Access (Clients) permission (ID #1543)
- Once granted, you'll find the module in the Directory workflow
Note: Administrators can manage permissions in Settings → Users / 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 Settings → Users / Access → Access tab → General or Clients sections.
Enable alert notifications to receive reminders when equipment installed for clients is due for follow-up.
- Navigate to Settings → Users / Access
- Select the user who should receive alerts
- Go to the Access tab
- Find the Clients section
- 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.