Skip to main content
The Portal & domain section of Settings, in the Access & integrations group, runs your white-label customer portal on a domain you control. The same domain carries inbound and outbound email. The section has four parts:

Who can use this

  • Only org admins see Portal & domain.
  • It is a Business and Enterprise feature. Organisations on the Starter plan don’t see the section. Organisations with no plan attached are treated as entitled and do see it.
  • To get it, upgrade from Settings › Plan & billing. See Plan & billing.
If the plan doesn’t include the portal, Deployment shows “Portal deployment is available on the Business and Enterprise plans.” with an Upgrade button that opens Plan & billing.

Add a custom domain

Use a subdomain you control, such as portal.yourcompany.com.au. One domain powers the portal URL, outbound email and DKIM signing.
1

Add the domain

Under Domain, enter your domain in the Domain field and click Add domain. UMS creates a hosted DNS zone for it.
2

Delegate your nameservers

Delegate your domain lists four nameservers. At your domain registrar, set the nameservers for your domain to those four. If your registrar separates custom nameservers from DNS records, use the nameservers setting.
3

Wait for verification

Delegation usually propagates in 5–60 minutes. Once it does, Utilified manages DKIM, SPF, MX and your SSL certificate, and the status changes to Verified.
Utilified uses nameserver delegation, not record-by-record setup. You won’t be asked to publish individual CNAME, TXT or MX records for the portal domain.

Verify your domain

The status badge next to your domain shows where verification is: While the badge shows Awaiting DNS, UMS checks every 30 seconds without a refresh. It pauses while the browser tab is hidden. After about ten minutes it stops checking on its own and asks you to click Check now to keep going. Check now also runs a check straight away and reports the result.

Deploy the portal

Deployment needs a verified domain with its hosted zone and SSL certificate in place. Until then it shows Prerequisites required, with a Configure domain button that takes you back to the domain setup.
1

Start the deployment

Click Deploy portal. Hover the button to see why it’s disabled, if it is.
2

Confirm

The Deploy portal dialog shows the address the portal will run at. Click Deploy.
3

Wait for it to finish

Deployment usually takes 3–5 minutes. A progress stepper shows each stage. When it finishes, the portal’s URL appears with a copy button.
Once the portal is deployed, click Update to redeploy it or Delete portal to remove it. Deleting can’t be undone, but you can deploy again later. If a deployment fails, click Retry deployment. Use the refresh icon beside the status badge to check the latest status.

Inbound and outbound email

Email delivery appears once you have added a domain. It has two switches:
  • Outbound email: send notifications from no-reply@yourdomain.
  • Inbound email: accept invoices and other mail at addresses like invoices@yourdomain.
Both need a verified domain. Until then, each switch is disabled and notes “Requires DNS verification.” Turning a switch on takes effect straight away. Turning one off asks you to confirm first: Turn off outbound email? or Turn off inbound email? Click Turn off to go ahead.
Turn on outbound email first to start sending branded notifications. Turn on inbound email when you’re ready to receive mail, such as supplier invoices, at your domain.

Change or remove your domain

You can’t rename a domain in place.
  • Change domain tears down the current domain, including its portal and email verification, so you can add a new one. You then delegate the new domain’s nameservers and wait for verification again.
  • Remove domain (the bin icon next to the status badge) reverts your portal to the default Utilified domain and tears down email verification.
Both open a confirmation dialog (Change domain? or Remove domain?) that warns the action can’t be undone. It lists what will stop, such as inbound or outbound email on the domain.

Default portal access

Default portal access sets what portal users see when their account has no portal access settings of its own. An account’s own settings, in the Portal Access section of its Settings tab, override these defaults. See Accounts.
  • Single sign-on: Let portal admins set up single sign-on lets portal admins connect their own company’s Microsoft sign-in for their account and its sub-accounts.
  • Portal Features: turn portal areas on or off, such as Validation outcomes, Invoices, Connections & meters, Agreements and Reports. Everything is on unless you switch it off. Features marked (opt-in), such as Budgets (opt-in) and Dashboards (opt-in), stay off until you switch them on.
  • Portal Reports: the reports portal users can run. Standard reports are on unless you switch them off, and opt-in reports are off unless you switch them on. This only applies while Reports is on.
Click Save Portal Defaults to apply your changes.

Troubleshooting

The section is missing

Portal & domain is for org admins on a plan that includes the portal. Upgrade from Settings › Plan & billing, or ask an org admin.

The status stays on Awaiting DNS

Check at your registrar that the domain’s nameservers exactly match the four shown in UMS. A trailing dot makes no difference. Delegation can take up to an hour.

The status shows Verification failed

This is usually a nameserver mismatch, or a registrar that hasn’t propagated the change. Check the nameservers and click Check now.

Inbound email won’t turn on

If turning on Inbound email shows “This domain is already enabled for another organisation.”, another Utilified organisation already receives email at the domain. Turn it off there first, or choose a different subdomain.

Deploy portal stays disabled with a verified domain

Hover the button for the reason. Usually a deployment is already in progress.