The portal is a separate, read-only app where one of your customers or suppliers signs in and sees only their own records: sites, sales, jobs, invoices, attachments and reporting. They cannot change anything.
There is no switch to turn the portal on. Access is given one person at a time, from the customer or supplier record (see Managing Customers and Managing Suppliers), and each invitation says which sites and which areas that person can see. People you invite are never members of your organisation, never use a Paperwork seat and never appear under Members.
Check who is allowed to invite
Portal access has its own permission module in Paperwork, called Portal. It has four permissions:
| Permission | What it lets someone do |
|---|---|
| View | See the Portal access tab on customers and suppliers, and the list in Settings |
| Create | Invite people and resend invitations |
| Edit | Change a person's sites, areas and end date |
| Delete | Revoke access |
The Paperwork Owner role holds all four. The Viewer role holds View only, so a viewer can see who has access but cannot invite anyone. For anyone else, tick the permissions on a custom role. See Members and Roles.
Invite someone to the portal
Open the customer or supplier
Click Customers or Suppliers under Relationships, then open the record. The Portal access tab sits near the end of the tab row, just before Activity. It only appears if your role has View on Portal.
Click Invite to portal
The button needs the Create permission. A panel titled Invite to the portal opens, with the line "They sign in with this email and see only" followed by the customer's or supplier's name.
Enter the email address
Type the person's Email address. Contacts already linked to this customer or supplier, or to one of their sites, are suggested as you type, as long as they have an email address and are not archived. Picking one links the portal access to that contact. You can also type any address.
Choose the sites
All sites gives access to every site, including any you add later. Specific sites lets you click Add site and pick from the customer's or supplier's active sites. You must pick at least one, or you will see "Choose at least one site".
Choose what they can see
Under What they can see, tick the areas. A customer can be given Sites, Sales, Jobs, Invoices, Attachments and Reporting. A supplier can be given Sales, Jobs and Attachments. Everything is ticked to start with, and at least one must stay ticked ("Choose at least one module").
Set an end date if you want one
Access ends (optional) takes a date from tomorrow onwards. Access stops at the end of that day. Leave it blank for access with no end.
Send the invitation
Click Send invitation. You will see "Invitation sent to" and the address.
If the email could not be sent, Paperwork still creates the access and shows "Access created but the email could not be sent — use Resend".
What a supplier is shown
When you invite a supplier, the panel reminds you of the limits. A supplier sees the sale title, the site name and address, the site contact's name and phone, waste lines without prices, its own participation rows and the statutory waste transfer and consignment notes. It never sees your customer's identity, your pricing or your invoices.
What the person receives
They get an email whose subject is your organisation's name followed by "has shared their portal with you". It has the heading Your portal access, names the person who invited them, and lists You can see, Sites and Sign in as. The Open the portal button takes them to the portal. The email says the invitation is tied to that address and gives the date it expires, which is 30 days after you sent it.
The email comes from the Portal invitation sender in email settings. Until you have a verified sending domain it comes from Dsposal's own address. Replies go to the person who sent the invitation.
On first use the person signs in, or creates a Dsposal account, with the address you invited. Their access is picked up automatically at that point and moves from Invited to Active. If you have invited the same address to several customers or suppliers, all of them arrive together.
See who has access
There are two places to look.
- The Portal access tab on a customer or supplier shows that record's people.
- Settings, then the Portal tab, shows everyone across all your customers and suppliers. It has a Party column, and the name links to that record's Portal access tab. It has no invite button. Invite from the record.
Both lists show Email (with the contact's name if you linked one), Sites, Can see, Status, Invited (the date and who sent it) and Last used. Search with "Search by email or party…" and narrow the list with All, Invited, Invite expired, Active, Ended or Revoked.
| Status | Meaning |
|---|---|
| Invited | Sent, not yet used. It is valid for 30 days |
| Invite expired | Not used within 30 days. Resend invitation gives it another 30 |
| Active | They have signed in and can see their records |
| Ended | The Access ends date has passed |
| Revoked | You removed access |
If you have not invited anyone yet, the list says "No one has portal access yet." (on a record) or "No portal access has been granted." (in Settings).
Anything a portal user exports is recorded in Paperwork's Activity.
Change what someone can see
Click the three-dot menu on their row and choose Edit access. It needs the Edit permission. The panel is titled Edit portal access and shows the address, which cannot be changed. Change the sites, the areas or the end date and click Save changes. You will see "Portal access updated".
A revoked person cannot be edited. Invite them again instead.
Resend an invitation
For a row showing Invited or Invite expired, choose Resend invitation from the menu. It needs the Create permission. Paperwork restarts the 30 days and sends the email again, and shows "Invitation resent to" the address. If the email fails you will see "The invitation email could not be sent — try again shortly", and you can try again.
Revoke access
Choose Revoke access from the row menu. It needs the Delete permission. Paperwork asks "Revoke portal access?" and tells you the person will lose access immediately and that you can invite them again later. Click Revoke and you will see "Portal access revoked". The row stays in the list as Revoked.
Deleting a customer or supplier also ends the portal access of everyone invited under it. They are told "Your access has been removed."
What portal users can and cannot see
Check the records before you invite, because the portal shows what is in Paperwork and nothing is hidden unless you hide it.
- Sales — every sale except a Draft.
- Jobs — every job except one still in Planning, and archived jobs. Suppliers never see Invoiced: it reads Completed to them.
- Invoices — only Authorised, Sent and Void invoices and credit notes. A Draft never appears, so a customer asking where an invoice is may simply be waiting for you to authorise it. Customers only.
- Prices — a sale with Hide total price switched on in Customise sales document shows no prices and no total in the portal. A waste line or extra that you have hidden from the PDF is also hidden from the portal. Job prices are always shown to a customer, apart from lines hidden from the PDF.
- Attachments — only files and links you have shared. Tick Share with portal users when you upload or add a link, or use the Shared switch in an attachments list. They show on the sales, jobs and invoices that person can open.
- Waste fates — the recovery and disposal figures in Reporting come from the waste fates recorded on each job's disposal site. Where a site has none, that waste shows as having no declared fate. See Managing Suppliers.
What the person actually sees is described in Customer Portal: Your Records and Customer Portal: Reporting. You can send them those guides.
When portal access stops working
- "Your access has ended." The Access ends date has passed. Edit the access to extend it.
- "Your access has been removed." It was revoked, or the customer or supplier was deleted.
- "This portal is currently unavailable. Contact the company that shared it." Your organisation's Paperwork subscription is not active. The portal stops for everyone until it is. Contact [email protected].
- No portal access yet is what they see if nobody has invited the address they signed in with. Check the address on their row.
What to do next
- Explore what customers and suppliers see in the portal
- See the reporting your customers get
- Set the Portal invitation sender so invitations come from your own domain
- Give your team the Portal permissions they need to invite
- Setup guide, step 12: Connect Xero, DWT and the customer portal if you are setting Paperwork up for the first time
Keep moving
Next steps
Explore further
Related Guides
Sign in to the portal and find your sites, sales, jobs, invoices, documents and attachments, then download a list as a CSV file
Read your recovery and disposal figures, tonnage and cost for any period, understand why waste shows as having no declared fate, and download the data behind it
Add customers and their sites, set the tax rate and payment term that drive invoice VAT and due dates, and fix the customer and site checks that block jobs
Add the carriers and disposal sites you use, import their registrations from the Environment Agency register, record waste fates, and understand the registration warnings on jobs
Give people a Paperwork seat, control what they can do with roles and permissions, and set your own notification preferences
Send Paperwork emails from your own domain, choose who each type of email comes from and set the default quote email
Optionally connect Xero, Digital Waste Tracking and the customer portal once your first job has gone through: map every nominal code and tax rate, link DWT codes to suppliers and containers, and invite customers one person at a time