Skip to content

Customer contacts and the client portal

Add the people at a customer, choose what each one is sent, and give them access to the client portal.

For office staffLast reviewed
On this pageBefore you start

A customer can have several people, and each one can be sent different things and given their own access to the client portal, rather than one shared login for the whole business.

Before you start

Only the owner, admins, dispatchers and office staff can manage a customer's contacts. Only the owner and admins can invite a contact to the client portal, generate a sign-up link, change what a login can see, or revoke access.

Add a contact

  1. Open the customer and, under Contacts, select + Add contact.
  2. Enter their Name, an optional Role (for example "Accounts" or "Site manager"), and either an Email or a Phone (at least one is required).
  3. Select Add contact.

The Main contact is the one your customer's own Email field mirrors, so editing either one moves both. A main contact cannot be removed directly; select Make main on another contact first.

Choose what each contact receives

Every contact has four switches: Invoices, Quotes, Reports and Reminders. Turn on whichever this person should be emailed. A contact who has unsubscribed shows "This contact unsubscribed. Nothing is emailed to them."

Give portal access

On a contact's row:

  • Invite to portal links the contact and emails them a link to set a password. The email is sent by ONYX1 with your business name as the sender name, and replies go to your business. The logo and accent colour appear only when your plan includes branding. Otherwise it uses your business name and the default colour. It ends with a small Powered by ONYX1 line. If that email already has a working ONYX1 login, this becomes Give portal access instead, so you can connect the existing login without a new invite.
  • Copy sign-up link is available for a linked contact without a password when no other provider shares that identity. It gives you a link to send however you like. The link expires in 14 days. Copying a fresh link replaces the previous one. If another provider shares the identity, email the link so only the person at that address can use it.
  • Resend invite appears for a linked contact who has not set a password. Wait a minute between sends; up to five sends in 24 hours, measured from the first invite attempt. The 24-hour period starts with the first invite and resets 24 hours later. The first invite counts, and a failed email still counts. The countdown shows when you can send again. Later waits can be five or 15 minutes. A resend replaces the previous link, and the previous link stops working. If an email arrives late, ask the contact to check their spam folder. If the email did not send, the card explains that the old link no longer works; wait for the countdown and select Resend invite again. Copy sign-up link is offered in that message only when it is safe for you to hold the link.
  • Email them a sign-up link appears for an unconfirmed account that is not linked yet. ONYX1 emails the link directly so only someone who reads mail at that address can complete it.
  • Revoke withdraws access at any time. After revoking, a contact without a password gets Restore access; a contact who already has a password gets Give portal access so you can restore access without another sign-up. Revoke and Give portal access change only your business's access. The login and password belong to the client: neither button changes them, and revoking leaves the client's access to any other business untouched.

What a login can see

Once a contact has portal access, choose Change under "Can see" to set:

  • Whole account: every job for the customer, plus every invoice and quote you have sent them, and every document in the customer's portfolio that you have shared with them.
  • Selected jobs: only the jobs you tick, and their site reports, safety documents and site photos when Share photos with the customer is on for that job, plus shared portfolio documents linked to one of those jobs. No invoices or quotes at all, even for the jobs you tick.

This only controls what they can open by signing in; what gets emailed to them is still the four switches above.

Occasionally a login has no matching contact any more (the contact was removed, or its email changed). These appear under Portal logins with no contact. Active entries keep the Revoke and Can see scope controls; withdrawn entries remain visible as Access withdrawn, so nothing is left unmanageable.

What the customer sees

A customer signs in to a light page with your business's name and either your logo or initials at the top. If they work with several businesses that use ONYX1, that name is also a switcher: it lists each one with what is waiting there, and the portal opens on the business that has something waiting, otherwise the one they used last.

If your ONYX1 account is suspended, your work is hidden from the client portal until your account is active again. Your clients keep their logins, and their access returns when your account is reactivated, with no new invitation.

The home screen has four summary tiles. To pay and Quotes to answer always appear. A Whole account login sees invoice totals and quotes waiting for an answer; a Selected jobs login sees Invoices not shared and Quotes not shared. Your jobs shows jobs in progress, and Shared with you shows site reports, safety documents and photos. On a phone the tiles use a 2-by-2 layout above the folder list.

The workspace starts at Home with three folders: Sites, Other jobs and Shared with you. A fourth folder, Documents, appears once this login can see at least one document you have shared from the customer's portfolio (see Keep a customer's documents). Each row shows the document's name, whether it is a PDF or a photo, its job if it has one, and the date. Selecting a row opens the file in a new tab. On a wide screen, the folder list stays on the left while the selected job or record opens in the detail panel on the right. The panel starts with the oldest overdue invoice when one needs attention, then a quote waiting for an answer; otherwise it opens the first available shared record or job. If there is nothing to open, it asks the customer to choose a site, job or record. On a phone, the folders and lists fill the screen. Opening a job or record shows a full-height sheet with a back arrow.

Open Sites to see a folder for each site where this login can see a job. A site row shows its label and address, how many active jobs it has, and the date of its latest activity. Open a site to browse its jobs, 20 at a time, newest first. The filters are All jobs, Reports, Safety documents and Photos; on a phone, All jobs and a Filter button open the other filters. Jobs without a site are in Other jobs, five at a time. Shared with you lists shared quotes, invoices, site reports and safety documents together, 10 at a time. Search that list to narrow it. Use Back or the breadcrumb to return to the previous folder.

Open a job to see its status, progress when available, Updated date, site and record groups. Quotes and estimates, invoices, site reports, safety documents and photos each open inside the detail panel with their shared item counts. Open a group to page through its records, then open a record in the same panel. For photos, choose a day; each photo list is paged 60 at a time. Use the back arrow or breadcrumb to return from a record to its group or job. On a phone, those same steps stay in the full-height sheet.

On Account → Your logo, a customer can upload, change or remove their logo. It updates each customer record linked to that login at its active providers. Staff at a provider cannot change or remove it while the link is active. If a provider revokes the link, the logo stays on that provider's customer record and staff can change or remove it. Removing the logo clears it from customer records still linked to that login.

Each job row and case file shows its progress bar and percentage when the customer-safe progress projection has a figure. A done job shows 100%. The progress bar can include an Updated date for the latest progress projection: for phases, the date changes when a phase percentage changes; without phases, it follows the latest progress update with a percentage. The case file also shows the job record's own Updated date. A job with no progress figure has no progress bar. Work on a job explains how the progress figure is worked out. Customers cannot see update text, phase names or who posted an update. The owner or an admin can hide progress for every job with Show job progress to customers in Settings → Security.

Shared with you contains quotes and invoices only for a Whole account login, plus site reports and safety documents the login can see. Selected-job access shows only the jobs the provider selected, and their site reports, safety documents and site photos when Share photos with the customer is on.

An invoice opened in the portal has a How to pay panel. ONYX1 does not take card payments: the panel shows the payment details you put in the invoice's Notes (such as your bank account), the invoice number to quote as the reference, and, for an invoice that came from Xero, that it can also be paid from the Xero invoice you emailed. If the invoice has no notes, it points the customer to the invoice PDF and the email. Put your bank account in the invoice Notes so it appears here.

A customer with portal access to a job sees its photos only while Share photos with the customer is on (see Work on a job). A new job follows Share site photos with customers by default in Settings → Security, which is off until an owner or admin turns it on. Only site photos are shared, each with its caption. Form and report photos, receipts and signatures are never shared. A photo is marked unverified on upload only while Flag photos that carry no camera information is on, and a photo marked unverified is never shown to customers. A site appears only while the login can see at least one job there, so a Selected jobs login sees only the sites of the jobs you ticked. Customers see a site's label and address and nothing else about it.

If a customer forgets their password

A customer who already has a portal login can set a new password themselves:

  1. On the client portal sign-in page, they select Forgot password?.
  2. They enter the email they sign in with and select Send me a link.
  3. If that email has a client portal login, ONYX1 emails them a link to set a new password. The link works for 1 hour, and asking again replaces the earlier link.

The page shows the same message whatever email is entered, so it never reveals whether an address has a login. Setting a new password signs that login out everywhere else. If the customer turned on two-factor authentication, they still enter their code when they next sign in.

If a link has expired or was already used, the page it opens points the customer back to Forgot password?.

Once a contact has a confirmed login, their contact row offers no sign-up link, so you cannot reset their password from there. Point them to Forgot password? on the sign-in page instead.

If something goes wrong

  • Give this contact an email address or a phone number. A contact needs at least one way to be reached.
  • This is the main contact. Make another contact the main one first. You cannot remove the main contact directly.
  • Add an email address to this contact first. A contact needs an email before you can invite them to the portal.
  • This email already has a portal account that has never been confirmed, so we can’t share your work with it yet. Send them a sign-up email: only someone who reads mail at that address can complete it, and then you can give them access. Use Email them a sign-up link instead of copying it yourself.