Unified Contacts

The Contacts page is a unified directory that shows all people connected to your store — customers, suppliers, and staff — in one place.

How It Works

Behind the scenes, every customer, supplier, and staff member is linked to a central contact record. This means:

• If the same person is both a customer and a supplier, they appear as one contact with multiple roles.
• Updating personal information (name, email, phone, address) on any role automatically syncs to all other roles.
• The POS app always has the latest information without manual updates.

Viewing Contacts

1. Go to Contacts in the sidebar.
2. Browse or search by name, email, or phone number.
3. Each contact card shows:
   • Name, email, phone, and address
   • Role badges — Customer, Supplier, User (with store names)
   • Quick links to open the full customer/supplier/staff profile

Cross-Role Sync

When you edit a customer's email address in the Customers page, the same email is automatically updated on their supplier record and user account (if they have those roles). This keeps information consistent across the entire system.

Customer Profile Photos

Contacts with a customer record can carry a store-captured profile photo. The photo shows in the contacts list, on the check-in face check, and it satisfies photo-required products at the register — so regulars only need their photo taken once.

From the Contacts page (back office)

• Open the contact — a camera button sits on the profile picture. Click it to upload a JPEG, PNG, or WebP photo (up to 5MB). The new photo replaces the old one everywhere immediately.
• A Remove photo link appears under the picture when a store-captured photo exists. Removing it falls back to the customer's own app selfie if they have a linked Kaminarigo account, or to their initials.
• Adding or changing photos needs the Edit customers permission (owners always can).

From the POS app (2.39 or later)

• Open Contacts, tap the customer, then the edit button. The edit form shows the current photo with Take photo and Gallery buttons.
• Photos upload immediately — no need to save the rest of the form.

Good to know: a customer's own app selfie displays as a fallback, but it never counts as the store-captured photo — photo-required sales and identity checks want a photo your staff took.

Customer Photo History

Every photo your staff capture of a customer is kept. Taking a new photo — at the register for a photo-required product, from the POS Contacts edit form, or from the Contacts page in the back office — adds to the customer's photo history rather than replacing the old file.

• Current photo — the newest photo is used for the check-in face check, photo-required sales, and the contacts list. Open the contact in the back office to see earlier photos under the profile picture.
• Switch back — click any earlier photo and choose Use as current photo. Nothing is deleted; the photos simply swap places.
• Remove photo — clears the current photo so the customer shows their initials (or their own app selfie, if they have a linked Kaminarigo account). The removed photo stays in the history and can be restored.
• Gallery — the Customer Photos tab lists every photo in the history, newest first, labelled with the customer's name.
• Storage — every customer photo counts toward your Drive storage, the same as other Gallery files. Because photos are kept rather than replaced, a customer photographed often uses more space over time. Once a store is past its storage grace period, adding photos from Contacts or the POS edit form stops until space is freed or the plan is upgraded; the photo a photo-required product asks for at checkout is always saved.

Who can edit customers from the POS

Changing a customer's name, phone, email, address, or profile photo from the POS app requires the Edit Customers permission on the staff member's role — the same permission that governs the Contacts page here. Owners always can. Staff without it can still search for customers, attach them to sales, and take the photo that a photo-required product asks for at checkout; the POS hides the edit button for them and the server refuses edits regardless of the app version.