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.
Step by step
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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 area | What it means |
|---|---|
| Users icon | The exact CentriPOS navigation icon for Contacts → Contacts. |
| Matching contact count | Active records remaining after the current quick view and search. |
| Search | Debounced multi-term query across identity, contact, address, source, role, code, and internal ID fields. |
| Search term rule | Every parsed term must match some supported column; up to eight terms are applied. |
| Phone-shaped search | Splits normalized digits into groups to tolerate displayed phone formatting. |
| All | Removes the quick-view condition while retaining search. |
| Has phone | Non-null primary customer_phone only; additional-phone arrays are not queried. |
| Has email | Non-null primary customer_email. |
| Companies | Non-null company_name; this is not the Associations Company list. |
| Imported | Non-null source_external_id. |
| Balances | Positive account balance or positive store-credit balance; row Balance still shows account balance only. |
| Clear search | Removes q and returns to page 1. |
| Contact row | Name/code/company, primary email/phone, address, and account balance; opens the profile outside the checkbox. |
| profileCustomerId | URL state for the open authenticated customer profile. |
| Page size | 50 server-returned active contacts. |
| Local page sort | Within-page tier ordering: named, email-only, phone-only, then unidentified. |
| Prev / Next | Move through server pages and clear selection. |
| Add Contact | Opens the New Customer sheet; existing-contact search and duplicate policy still apply. |
| Export permission | customers.export capability required before Export renders. |
| Export scope | Every active contact matching current search and quick view, fetched in 1,000-row batches; not the page or selection. |
| Export fields | Codes, internal ID, identity/contact/address, balances, credit limit, tax flag, contact-only flag, created, and updated values. |
| XLSX / CSV | Sensitive contacts-export-YYYY-MM-DD file formats. |
| Bulk-action permission | Verified tenant manager, Owner, Store Owner, Super Admin, or Manager. |
| Select row | Adds only that visible contact to the current page selection. |
| Select all contacts on this page | Selects the current page only. |
| Selection reset | Tenant, search, view, or page change clears selected IDs. |
| Merge | Enabled for exactly two selected contacts. |
| Add to group | Keeps existing membership and adds missing selected customer IDs to one existing group. |
| Legacy group-email guard | Maps one unambiguous email-only membership or avoids adding duplicates when a shared email is ambiguous. |
| Add to association | Keeps existing links and inserts missing member relationships into one existing household/company. |
| Touch destination sheet | Phone bottom picker for group or association; desktop uses a dialog. |
| Clear | Leaves bulk-selection mode without changing contacts. |
| Duplicate scanner | Owner/admin-only pending shared-email/phone review queue. |
| No contacts match your search | Search-empty active result. |
| No contacts found | Unsearched current-view/source empty result. |
| Sensitive screenshot boundary | The 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.
CentriPOS API explorer · API Center administration