For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
DashboardGet an API key
SetupCustomersOnboardingsWorkbenchAsk PiIntegrations
SetupCustomersOnboardingsWorkbenchAsk PiIntegrations
  • Setup
    • Overview
    • Create your workspace
    • Invite your team
    • Roles and permissions
    • Branding and logos
    • Portal settings
    • Connect your CRM
    • Plans and seats
    • Payment method
    • Invoice access
LogoLogo
DashboardGet an API key
On this page
  • What the customer sees
  • The fields that matter
  • Custom domain on Pro
  • A gotcha worth flagging
  • What the customer can’t do
  • Related
Setup

Portal settings

Your customer's view of the onboarding. Pick the URL, the sections they see, and the welcome line.
|View as Markdown|Open in Claude|
Was this page helpful?
Previous

Branding and logos

Next

Connect your CRM

Built with

The portal is the surface your customer’s team logs into. It shows them the phases of their onboarding, the tasks you’ve marked customer-facing, the resources you’ve shared, and (on Pro) a comment thread per task. Internal-only tasks stay invisible. The portal does not show your team’s private notes, internal task assignees, or your other customers.

Settings live under Admin > Portal.

What the customer sees

Once configured, your customer gets a single URL (e.g. acme.pivotal.app/portal/contoso) and a magic-link login on the email you have on file. Their landing view is a checklist organized by phase. Each phase shows progress, the current task they own, and tasks blocking your team. They click a task, read your instructions, attach a file, mark it done.

The fields that matter

FieldWhat it doesNotes
slugSets the portal URL: yourname.pivotal.app/portalEditable. Old slug 301s for 24h.
custom_domainReplaces pivotal.app with your own (e.g. onboarding.acme.com)Pro plan only. Requires CNAME.
welcome_messageTop-of-portal greetingMarkdown supported. 280 char max.
sections.tasksShow the tasks listOn by default.
sections.resourcesShow shared files and linksOn by default.
sections.commentsEnable per-task comment threadPro plan only.
sections.teamShow the customer-facing team rosterOff by default.
default_themeLight, dark, or system for new portal usersPer-user override always allowed.

Custom domain on Pro

Custom domain takes a CNAME pointing onboarding.acme.com to portals.pivotal.app. Pivotal provisions a certificate via Let’s Encrypt inside ten minutes. Until the cert lands, the domain serves a “setting up” page. Once it’s live, both the custom domain and your original *.pivotal.app/portal URL keep working. Magic-link emails default to the custom domain.

A gotcha worth flagging

Toggling sections.resources off does not delete the resources you’ve already uploaded; it hides the section. Toggling it back on restores the section with every resource intact. The same is true for comments: turn the section off, the threads remain, the customer can’t read or post until you turn it back on.

What the customer can’t do

Customers cannot reorder phases, add tasks, change task assignees, or invite other people from their company. To add a second contact at the customer, use Add contacts on your side.

Related

  • Branding and logos
  • Add contacts
  • Task completion

Email help@pivotal.app with a screenshot of where you got stuck and the customer or onboarding id from the URL.