Open Contacts → Contacts with the Users icon. This is a tenant-wide customer-record surface containing personal and financial information. Search, quick view, page, and the open profile ID are stored in the authenticated page URL, but access still requires the signed-in user’s tenant permissions. Export and bulk actions are separately permission-controlled. No customer-list screenshot is published because the Harbor & Hearth capture was rejected as sensitive.

Before you beginSearch by more than one identity field before creating a record. Keep customer and payment information out of screenshots and free-form notes unless it is required.

Step by step

  1. Go to Contacts → Contacts and confirm the active business. The count beneath Contacts is the number of active customer records matching the current quick view and search—not always the tenant’s unfiltered lifetime contact count. Archived or inactive records excluded by the active-customer lookup helper do not participate.
  2. Use Search names, phone, email, address, company…. Input waits about 300 milliseconds, normalizes spaces, resets to page 1, and writes q to the URL. It searches customer code, name, company, primary email and phone, legacy/full address fields, street lines, city, state, ZIP, imported code and external ID, contact role, and internal customer ID.
  3. Understand multi-term search. Up to eight parsed words, email-like tokens, or digit groups are applied one after another, so every term must match at least one supported column. A phone-shaped query is split into digit groups to tolerate common formatting. Search does not inspect notes, additional phone-line arrays, sales, groups, associations, or activity.
  4. Choose All, Has phone, Has email, Companies, Imported, or Balances. Has phone and Has email require a non-null primary field, even if it contains an empty legacy value. Companies requires non-null company_name. Imported requires non-null source_external_id—not merely a local or imported-looking customer code.
  5. Balances includes a customer when account balance is greater than zero or store-credit balance is greater than zero. It excludes zero and negative balances and does not net the two amounts. The row’s Balance column displays only customer account balance; open the profile or Store credit workspace for store-credit detail.
  6. Clear Search with X and return to All before treating a contact as missing. Search and quick-view changes reset pagination and clear any selected rows. The URL preserves q, nondefault view, and zero-based page state for an authenticated permitted user.
  7. Read a row. Contact shows avatar initials, customer name or Unknown, local customer code, and company. The next Contact column shows primary email and phone. Address shows street/city/state/ZIP or the legacy address. Balance is the customer account balance. On mobile, address and company are omitted from the compact card.
  8. Choose the row outside its selection checkbox to open the Customer Profile. The URL stores profileCustomerId so browser history or a copied authenticated link can reopen that customer. Closing the panel removes the profile parameter without discarding the list search, view, or page.
  9. Use Prev and Next when more than 50 records match. The footer shows the displayed range and Page n of total. Server pagination first orders by customer_name; the 50 rows on each page are then locally reordered so named profiles appear before email-only, phone-only, and otherwise unidentified records. Do not assume the visible sequence is one globally sorted alphabetic list across pages.
  10. Choose Add Contact to create a customer. Search first, because Add Contact does not mean the current search proved no duplicate exists; the New Customer save performs its own email/phone check according to tenant duplicate policy.
  11. Export appears only with customers.export permission. Choose Export as XLSX or Export as CSV. Export fetches every active contact matching the current search and quick view in stable 1,000-row batches; it is not limited to the visible 50-row page or currently selected checkboxes.
  12. Review export contents before sharing. It includes local and imported codes, internal customer ID, display name, company, primary email and phone, address fields, full address, account balance, store-credit balance, credit limit, tax-exempt flag, contact-only-profile classification, created time, and last-updated time. The file is named contacts-export-YYYY-MM-DD and contains a Contacts sheet for XLSX.
  13. If no contacts match the export filters, CentriPOS stops with No contacts match the current export filters. Treat the exported file as sensitive customer and financial data: save it only to an approved location, share with the minimum audience, and delete stale copies according to policy.
  14. Bulk selection appears only when tenant-management authority or an Owner, Store Owner, Super Admin, or Manager role is verified. If permission resolution fails, the destructive controls remain hidden. The duplicate-scanner banner has a narrower owner/admin gate and does not automatically appear for every manager.
  15. Check individual rows or choose Select all contacts on this page. The header checkbox selects only the current 50-row page. Changing tenant, search, quick view, or page clears the entire selection, so bulk actions cannot silently span pages. Read the selected count before acting.
  16. Choose Merge only with exactly two selected contacts. It loads their current complete records and opens the irreversible field-by-field merge dialog. One selected row says Select one more contact; more than two says Merge compares exactly two contacts at a time.
  17. Choose Add to group to select one existing alphabetized customer group. Existing memberships are kept. CentriPOS avoids duplicate customer-ID membership; it can safely attach one unambiguous legacy email-only membership to its exact customer, and avoids duplicating an ambiguous shared-email legacy row. No group found means create one under Contacts → Groups first.
  18. Choose Add to association to select one existing Household or Company association. Existing member links are kept; new links store the selected customer ID and display label. This does not copy association profile fields, set company member roles, or merge customers. Configure those details in Contacts → Associations.
  19. On a touch phone, the group/association destination opens as a bottom picker sheet; on desktop it uses a dialog. Search the destination list, select the exact row, then choose Add. The picker cannot be dismissed while the save is in progress.
  20. Choose Clear to leave selection mode without changing customer records. After any bulk action, open the destination Group or Association and a representative Customer Profile to confirm membership. After Merge, verify the surviving record and financial/history reconciliation separately.
  21. Interpret empty states precisely. No contacts match your search means q excluded every active record. No contacts found means the current quick view/source has no rows without a search. Neither state proves the tenant never had a customer or that inactive records do not exist.
  22. The owner/admin duplicate scanner can appear above the list when pending shared-email or phone candidates exist. A candidate is review evidence, not a confirmed duplicate; use Ignore, Household, or the full Merge comparison according to verified identity.
  23. No real screenshot is shown for this article. The Harbor & Hearth manifest explicitly marks /contacts/list rejected-sensitive-customer. The help center keeps this guide text-only rather than exposing customer records or substituting an invented list.

Screen and contract reference

Control or areaWhat it means
Users iconThe exact CentriPOS navigation icon for Contacts → Contacts.
Matching contact countActive records remaining after the current quick view and search.
SearchDebounced multi-term query across identity, contact, address, source, role, code, and internal ID fields.
Search term ruleEvery parsed term must match some supported column; up to eight terms are applied.
Phone-shaped searchSplits normalized digits into groups to tolerate displayed phone formatting.
AllRemoves the quick-view condition while retaining search.
Has phoneNon-null primary customer_phone only; additional-phone arrays are not queried.
Has emailNon-null primary customer_email.
CompaniesNon-null company_name; this is not the Associations Company list.
ImportedNon-null source_external_id.
BalancesPositive account balance or positive store-credit balance; row Balance still shows account balance only.
Clear searchRemoves q and returns to page 1.
Contact rowName/code/company, primary email/phone, address, and account balance; opens the profile outside the checkbox.
profileCustomerIdURL state for the open authenticated customer profile.
Page size50 server-returned active contacts.
Local page sortWithin-page tier ordering: named, email-only, phone-only, then unidentified.
Prev / NextMove through server pages and clear selection.
Add ContactOpens the New Customer sheet; existing-contact search and duplicate policy still apply.
Export permissioncustomers.export capability required before Export renders.
Export scopeEvery active contact matching current search and quick view, fetched in 1,000-row batches; not the page or selection.
Export fieldsCodes, internal ID, identity/contact/address, balances, credit limit, tax flag, contact-only flag, created, and updated values.
XLSX / CSVSensitive contacts-export-YYYY-MM-DD file formats.
Bulk-action permissionVerified tenant manager, Owner, Store Owner, Super Admin, or Manager.
Select rowAdds only that visible contact to the current page selection.
Select all contacts on this pageSelects the current page only.
Selection resetTenant, search, view, or page change clears selected IDs.
MergeEnabled for exactly two selected contacts.
Add to groupKeeps existing membership and adds missing selected customer IDs to one existing group.
Legacy group-email guardMaps one unambiguous email-only membership or avoids adding duplicates when a shared email is ambiguous.
Add to associationKeeps existing links and inserts missing member relationships into one existing household/company.
Touch destination sheetPhone bottom picker for group or association; desktop uses a dialog.
ClearLeaves bulk-selection mode without changing contacts.
Duplicate scannerOwner/admin-only pending shared-email/phone review queue.
No contacts match your searchSearch-empty active result.
No contacts foundUnsearched current-view/source empty result.
Sensitive screenshot boundaryThe exact Harbor & Hearth customer list was rejected, so no screenshot is published.

Expected result

The active Contacts count, 50-row page, quick view, and every multi-term search result reconcile to the documented query fields; export contains every permitted match rather than only the page or selection; bulk actions affect only the reviewed page-selected IDs with the required authority; profile URL state reopens the intended customer; and no sensitive customer record appears in public screenshots or uncontrolled exports.

Troubleshooting

  • Search by more than one identity field before creating or merging a customer.
  • Confirm the selected customer, company, or household before changing balances or associations.
  • Do not place payment credentials or unnecessary private information in notes.

More guides

Build an itemized payment in MoneyUse Products or Amount & description to build one receipt, attach the customer, and follow the appropriate payment or service-estimate workflow.
Take a one-time payment in Virtual TerminalReview a one-time amount, tax and contact at the correct payment station, use its verified secure checkout, and recover the original receipt after an uncertain result.
Review booking payments, refunds and earned careKeep a booking’s customer payments, unused advances, completed care, cancellation fees and refunds distinct, then read a correctly scoped accrual report.
Configure booking properties and customer pagesSet accommodations, service packages, availability, required intake and payment terms, then review the correctly branded booking page before sharing it.