Catalog & domains

Set up a custom training portal domain

Put your public catalog on your own hostname with a DNS CNAME.

Your public learning catalog can live on your own hostname — for example learn.example.com — in addition to {slug}.app.mentorhq.com. Learners browse, sign in, and enroll without ever leaving your brand URL.

Before you start

  • Catalog must be enabled for your organization.
  • Pick a subdomain you control (learn.example.com, lms.example.com, training.example.com). Apex/root domains are not supported for the portal.
  • Self-serve domain management under Admin → Organization is marked Soon, so setup is coordinated with Mentor.

Steps

  1. Request the domain. Contact support@mentorhq.com (or your Mentor contact) with your organization slug and the exact hostname. Mentor attaches the hostname to your organization and to sign-in, and replies with your CNAME target.
  2. Publish the DNS record. At your DNS provider, create a CNAME from your hostname to the target Mentor provided:

```

learn.example.com CNAME <target provided by Mentor>

```

Do not proxy or point the same hostname at another platform at the same time.

  1. Wait for DNS and the certificate. Propagation usually takes minutes but can take up to an hour or more with high TTLs. Once the record resolves, an SSL certificate is issued automatically — no certificate files to upload. Expect the whole process to complete within an hour of publishing the record.
  2. Verify. Open https://learn.example.com — you should see your branded catalog. Then test Sign in to enroll on a course: sign-in should complete and return you to the same hostname.

Good to know

  • Your {slug}.app.mentorhq.com address keeps working alongside the custom domain.
  • Sessions on a custom host stay on that host — signing in on learn.example.com does not automatically sign you in on app.mentorhq.com.
  • The custom domain serves the learner-facing catalog. Admin and Studio remain on app.mentorhq.com and studio.mentorhq.com.
  • Your branding (logo, colors, wordmark) applies automatically.

If the site does not load after an hour, see Custom domain pending or not working.