Portal Studio
Updated
Portal Studio is where you design what the customer portal shows. You build a portal from pages and widgets, give it a brand and layout, and assign it to playbooks so their projects open in it.
Portal Studio is available when it's turned on for your organization. If you don't see it, contact your OnRamp team. Without it, Settings > Portals shows a single Portal settings form.
When to use it
Use Portal Studio when different playbooks need a different customer portal, or when you want to control the brand, layout and content customers see. Super Admins and Creators can create and edit portals.
How it works
The portals list
Go to Settings > Portals. You see every portal with its status, the playbooks using it, and when it was last edited. Use Search portals to find one. The Used in popover lists each assigned playbook and links to it.
A portal row's actions menu offers Preview, Edit in Portal Studio, Set as Default and Delete:
Set as Default appears only on portals that aren't the default, and works only once the portal is published.
You can't delete the default portal.
Preview and Edit in Portal Studio aren't available on Legacy portals.
The account home is pinned above the list. It lists every project on a customer's account.
Only Super Admins see the Access tab. It holds Portal name, Sign-in subtitle with a sign-in preview, Domain, Sign-in (Passwordless magic link), Stay signed in for (1 to 365 days) and Self-service sign-up. Self-service sign-up shows Off when it isn't turned on for your organization.
Create a portal
The first page you see depends on whether Aero is available for your organization:
When Aero is available, the page is headed Describe your onboarding. Describe your onboarding and select Build with Aero, and Aero builds the pages, content and brand. The templates follow under Or start from a template.
When Aero isn't available, the page is headed Pick a starting point and shows only the templates.
Four built templates can be previewed under your brand with Preview: Guided onboarding, Supplier onboarding, Dealer & partner activation and Client implementation. The Blank canvas card starts from scratch and has no preview.
Brand
New portals start from your organization's brand defaults. Changing those defaults sets the starting point for new portals but doesn't restyle existing ones. To set them, see Branding & Portal Customization.
Inside a portal, you can choose from eight palette presets (Core Purple through Slate), three type pairings (Modern, Friendly and Editorial) and six style presets (Classic, Bold, Friendly, Corporate, Editorial and Minimal).
Offer dark mode is on by default. What customers see first offers Light, Dark or Match device, and Match device is the default.
Asset | Files accepted |
|---|---|
Logo | PNG, JPG, GIF, WEBP or SVG, under 512 KB. You review it in Review your logo, then select Save logo. |
Dark mode logo | Appears only while Offer dark mode is on. Left empty, your light logo shows on the dark card behind it. |
Hero image | JPG, PNG, GIF or WEBP, under 1 MB |
Favicon | PNG, JPG, GIF, WEBP, ICO or SVG, under 128 KB |
Layout
Navigation position: Top or Left.
Content width: Centered or Full width.
Footer: off by default.
AI assistant: on by default. It appears only when the assistant is available for the portal. To set up the agent's tone and knowledge, see Set up the portal agent's tone and knowledge.
Sidebar: off by default. Sidebar position is Left or Right, and it sits on the right while navigation is on the left. You can also set Shared sidebar and Hero spans full width.
Pages and widgets
To add a page, select Add page. To rename a page, edit its Page title. Delete page is unavailable when the portal has one page, when the page holds a widget customers always see, or on the Portal Embed page.
Every portal has its own Portal Embed page. It stays out of the portal navigation and can't be deleted. If it holds widgets that need a portal sign-in, the inspector asks you to remove them before you publish. To embed the portal, see Embed the Customer Portal in Another Application.
Some widgets have limits:
Always full width, in the main column: Welcome hero, Progress tracker, Project timeline, Your projects and Start a project.
One per page: Next step spotlight, Waiting on you, Hours invested, Project timeline, Conversations, Welcome message, Your projects and Start a project. Road ahead, an account home widget available when customer journeys are turned on for your organization, is also one per page.
Project pages only: Progress tracker, Project tasks, Project timeline, Resources, Your team and Welcome message.
Favorites keeps up to 20 saved items per project.
Hours invested is available once time tracking is turned on.
Start a project lists your self-serve playbooks. To set one up, see Self-Serve Playbooks.
Project timeline shows a Today line. With no stages, it says your team is working behind the scenes. When the project is finished, it shows Onboarding complete. Opens showing sets Current, All or None. Flag late work marks only tasks the customer owns. Customers can switch Auto, Week, Month or Quarter unless Lock timeline scale is on.
Save and publish
Save draft keeps your work. The status pill reads Not saved, Unsaved changes, Draft, Live or Not published. If you leave with unsaved changes, a dialog offers Discard, which drops those unsaved changes. A saved draft is kept.
Publish opens Publish <portal name>. It shows:
How many playbooks and projects will use this version, with Change. When there are none, Not assigned to any playbooks appears with Assign. Change opens Publish <portal name> to, where you pick playbooks and Aero's picks appear under Suggested.
Readiness checks. They check that the portal has at least one page, each page has a name and content, required widgets are in place, content widgets have content, and links have valid destinations. Advisory checks cover unreadable dark mode colors, an empty sidebar and too little room beside it. The summary reads N things to look at when a check fails, N advisory items to review when only advisory checks flag something, or All N checks passed.
An optional Aero review, shown when Aero is available for your organization. Select Review for suggestions, some with Apply fix.
Finish by selecting Publish now or Publish to N projects. Running projects of the playbooks you select move to the new version. Projects you uncheck stay on their version.
Assign portals
In a playbook's settings, choose a portal under Customer portal. Default portal follows whichever portal is the default.
A project's portal settings let one project differ:
Customer portal picks the portal and shows its version. Update to v# moves it to the latest version.
Portal Content overrides widget content for this project.
Portal Branding overrides the brand for this project.
Limits
Your plan sets how many portals you can have. At the limit, New portal is disabled and says so. The account home and Legacy portals don't count.
You can't delete a portal assigned to an active playbook, or one that running projects launched with. Reassign those playbooks first. Archived playbooks still assigned to it fall back to the default.
There must always be one default portal.