Find a customer's files in the portfolio
Find a customer's case files and documents to preview, download or zip. The owner, admins, dispatchers and office staff can also keep the customer's own documents here and open their drafts.
On this pageBefore you start
The portfolio is where you go to find records. Work is for running today's jobs; the portfolio is organised by customer, and every job is a case file holding everything filed against it.
Before you start
Everyone can open the portfolio, but what you see depends on your role.
- The owner, admins, dispatchers and office staff see every customer, including the Documents and Draft jobs folders, and every money folder: Quotes, Invoices, Customer POs and Purchases. They also see how much a customer owes you.
- A site supervisor sees every customer and case file, but not the money folders, not the customer's documents and not what a customer owes. Their Forms and sign-off folder holds only the forms they filled in themselves, plus the job's customer sign-offs.
- A tech or contractor sees only customers of jobs they are assigned to, and only those case files. They see Safety documents, Site reports, Photos, Forms and sign-off (their own forms and the job's sign-offs) and Incidents (only the incidents they reported themselves). They never see the money folders, the customer's documents or a customer's contact details.
- Safety documents and Incidents appear only when your company has the Safety module. Site reports appears only when Site reports is on for your company. A folder hidden by either setting is not included in a downloaded zip.
- Dispatchers and office staff see a customer purchase order only when an invoice refers to it. Owners and admins see them all.
Profit and margin never appear in the portfolio.
Open a customer's portfolio
- On Customers, select Portfolio at the top of the page. On a phone, select Portfolio in the Customers / Portfolio switch at the top. Techs and contractors don't see Customers, so they go straight to Portfolio.
- A customer is listed once one of their jobs is completed, ready to invoice or invoiced, or they have an invoice that is not void. Use Open jobs for customers with work under way. Archived appears when you have archived customers.
- Search by customer name, site, job number or job title, sort by Most recent, A to Z or Most jobs, and switch between the grid and the list.
- Select a customer. Owners, admins, dispatchers, office staff and site supervisors can also select Open portfolio on the customer's own page.
Find a file
On a customer's page you see the customer's folders (Documents, Quotes, Invoices and Customer POs, for roles that can see them) and every job as a case file, newest first. If the customer has more than one site, select a site to narrow the list.
The owner, admins, dispatchers and office staff also see Draft jobs. Site supervisors, techs and contractors do not see this folder.
Keep a customer's documents
The Documents folder holds the customer's own paperwork, such as a work order, a proposal or a contract, as a PDF or a photo. Only the owner, admins, dispatchers and office staff can see it or change it.
- Open the customer and select Documents, then select Add document.
- Choose a PDF (up to 20 MB) or a JPEG, PNG or WebP photo. The Name fills in from the file name; change it if you like.
- Optionally choose a Job. Only this customer's jobs are offered, and an archived job cannot be chosen. A linked document also shows in that job's case file, in the Customer documents folder.
- Turn on Share with customer if the customer should see it in their portal.
- Select Upload.
Select a document's name to open it. Select Edit to rename it, change or clear its job, or change Share with customer; the Share switch on each row changes sharing straight away. Select Delete to remove the document from the portfolio, its case file and the customer's portal. You are asked to confirm, and it can't be undone.
A shared document shows in the customer's portal only to logins that can see it: a Whole account login sees every shared document, and a Selected jobs login sees only shared documents linked to one of its jobs. See Customer contacts and the client portal.
Start a draft from the portfolio
- Select Draft jobs, then select New draft. The customer is already selected.
- If you have photos, drop them into Drop photos here on a laptop or desktop. On a phone, select Take photo or Choose from library.
- Select Save draft on a laptop or desktop, or Save on a phone. ONYX1 gives the draft a title such as Draft · 8 Oct. Other details are optional. Select Optional details to add them now, or edit the draft later.
Browse a case file
- Select a case file. On a wide screen, its folders are across the top: Safety documents, Site reports, Photos, Forms and sign-off, Incidents and, for roles that can see them, Quotes, Invoices, Customer POs, Purchases and Customer documents. On a phone, select Change folder to open the folder list; while searching, select Browse folders.
- The list shows one page at a time. Use Previous and Next below the list, or the preview arrows, to move between pages. Search words and type or date filters stay applied as you move.
- Select a file. On a wide screen it opens in a panel beside the list, so the page does not change, and the up and down arrows step to the previous or next file, including across pages. On a phone or tablet it opens full screen, with arrows to move between files.
- Select Download to save it, or Show on the job to go to the job. On a wide screen, photos and PDFs also have Full screen; on a phone or tablet you also get Share. A form or an incident has no file to download: its details show in the panel. A quote or an invoice opens in its own tab, from Open quote or Open invoice.
On Portfolio, the search box finds customers, jobs and files; file and job matches appear below the customer list and have their own pages. On a customer or case file, type words into the search box to find files. Search matches file names, numbers (JOB, QU, INV and PO), photo captions, job titles and report types. It does not read inside PDFs. Narrow the results by type or by date.
Download a zip
The owner, admins, dispatchers, office staff and site supervisors can download several files at once. Techs and contractors download single files only.
- On a customer's page, select Download zip for everything, or Download what is shown after you have searched or chosen a site. In a case file, Download case file ignores the current page, search words and date filters. It queues the whole case file, or all files of the selected result type if you chose one.
- Or tick the files you want. Your selection stays checked as you move between pages. Select Download zip in the bar that appears to download only those selected files.
- The zip builds in the background in parts of up to 100 MB. When it is ready, it appears under Your zips (your latest four) on the portfolio pages, with a download link for each part. It stays for 7 days.
Each zip uses one background export from your organisation's monthly allowance, the same allowance as Settings → Exports. Only the owner and admins see that count.
The zip has a folder for the customer, then each job, then each folder. Each part has a manifest.csv that lists every item in that part, including anything left out and why. Customer signatures are never put in a zip. Quotes and invoices are listed in the manifest but are not in the zip; open them from the app. Forms and incident records are listed too, without a file. A site supervisor's zip leaves out the money folders.
If something goes wrong
- Your organisation has used all its background exports for this month. Zips and background exports share one monthly allowance, which resets on the 1st. You can still download single files.
- You already have 2 zips building. Wait for one to finish, then try again.
- You have started 20 zips today. That is the most one person can start in a day. Try again tomorrow.
- Your team already has 4 zips building. Try again in a few minutes.
- This zip is too large to build in one go (over 2 GB). A single zip holds up to 25 parts or about 2 GB. Download a smaller selection, or filter by site, type or date.
- There are no files to download for that. Nothing matched your selection or filters.
- Your role can't download zips. You can still download single files. Only the owner, admins, dispatchers, office staff and site supervisors can download zips.
- Expired after 7 days. Download it again from the customer or case file.
