Skip to content

docs: add portal deployment and custom-domain setup guide#7

Open
mintlify[bot] wants to merge 3 commits into
mainfrom
mintlify/8f4debb2
Open

docs: add portal deployment and custom-domain setup guide#7
mintlify[bot] wants to merge 3 commits into
mainfrom
mintlify/8f4debb2

Conversation

@mintlify

@mintlify mintlify Bot commented Jun 9, 2026

Copy link
Copy Markdown
Contributor

Summary

Documents the white-label portal Deploy flow and the custom-domain UX exposed in Settings → Portal, aimed at Organisation Admins.

Changes

  • Added settings/portal-domain.mdx covering:
    • Plan gating (portal deploy on Business/Enterprise; upgrade CTA otherwise; email-only framing on lower plans).
    • Adding a custom domain via nameserver delegation (Utilified manages DKIM/SPF/MX/SSL inside its hosted zone).
    • Auto-polling verification (visibility-aware, paused-after-cap behaviour, Check now).
    • Deploy portal prerequisite tooltip and disabled states.
    • Inbound and outbound email toggles, both gated on DNS verification.
    • Explicit Change domain flow (remove → re-add).
    • MUI confirmation dialogs with warnings on destructive/impactful actions.
    • Troubleshooting for common verification, conflict, and deploy states.
  • Cross-linked the new page from settings.mdx.
  • Added the new page to the Settings & Notifications nav group in docs.json.

Context

Reflects the UX shipped in utilified/ums-web#447 ("feat: plan-gated portal UI + custom-domain delegation UX").

@mintlify

mintlify Bot commented Jun 9, 2026

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
utilified-docs 🟢 Ready View Preview Jun 9, 2026, 2:11 AM

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants