Skip to main content
White-Label Client Portal

Guide New Clients with Portal Onboarding

Build a short guided tour of the client portal that each client user sees when they first sign in, in their own language.

Written By voiceaiwrapper

Last updated 26 days ago

Onboarding is a short guided tour of your client portal. The first time a client user signs in, the portal highlights the sidebar pages you chose, one at a time, with a title and a sentence or two you write for each. It helps new clients find their agents, calls and campaigns without a call to your team. Setting it up takes about ten minutes.

Onboarding is available on every plan.

Before you start

How onboarding works for your clients

  • Each client user sees it once. It starts on their first sign-in. When they click Finish or Skip onboarding, it's marked complete and never shows again for that user. If they close or reload the portal halfway through, it starts again from step 1 next time.
  • Steps adapt to each client. A step is skipped when its page isn't in that client's sidebar, for example because of their engine, their access permissions or a page hidden from the sidebar. If none of the steps apply to a client, they don't see onboarding at all.
  • Steps run in the order you set, not the sidebar order. Each page can be used in one step only.
  • It's shown in the client's portal language, falling back to English for any language you haven't written.
  • It doesn't run on phones, or when the portal is embedded in another site.
The client portal on a client user's first sign-in: the sidebar highlighted on Dashboard, the onboarding card with the step title and description, Skip onboarding and Next (1 of 4), and the rest of the portal dimmed.

Step 1: Open the onboarding builder

  1. In the sidebar, open Client Portal β†’ Sidebar.
  2. Open the Client onboarding tab.

The page has the step builder on the left and a Client preview on the right. The preview needs a wide window (about 1280 pixels); on a smaller screen it's hidden.

Client Portal β†’ Sidebar β†’ Client onboarding tab at full desktop width: the collapsed "How onboarding works for your clients" alert, the "Let clients skip onboarding" switch, the English language chip, two filled step cards (sidebar page, title, description with counters) and, on the right, the Client preview with provider tabs and the tooltip next to the highlighted sidebar page.

Step 2: Decide whether clients can skip

Let clients skip onboarding is on by default. Clients then see a Skip onboarding button on every step, and skipping counts as completing it.

Turn it off if you want every client to go through to the end. There's then no Skip onboarding button, and clients click through until they reach Finish on the last step.

Step 3: Add your steps

For each step:

  1. Under Sidebar page, choose the page to highlight. Pages already used in another step aren't listed. A blue dot marks a built-in page and an orange dot one of your custom pages.
  2. Type a Title (up to 60 characters), for example "Your AI agents".
  3. Type a Description (up to 240 characters) that tells the client what the page is for and what to do there.

A new empty step appears as soon as the current one has a page. You don't need to fill it; empty steps are ignored. To remove a step, click the trash icon on its card. To change a step's page without losing its text, pick another page, or choose No page / Clear selection.

Some pages only exist on one engine. They show a hint such as "Vapi only. Skipped for clients on other providers." Those steps are skipped for clients on other engines, so write each step so the tour still makes sense without them.

Keep it short. Three to five steps on the pages clients use most (agents, campaigns, call logs, billing) works better than a step for every page.

Step 4: Write the steps in your other languages

English is required. Your other enabled languages appear as chips above the steps:

  1. Click + Add Language and pick a language.
  2. Select its chip. The step cards now edit that language. The English text is shown under each field as a reference.
  3. Fill in a title and description for every step.

A badge on the chip counts the steps still missing text. You can't save until every added language has a title and description on every step. To drop a language, select it and click Remove followed by the language name, for example Remove Spanish.

If + Add Language is greyed out, there are no more languages enabled for your portal. Turn them on under Portal Configuration β†’ Localization first.

Step 5: Choose what Finish does

By default, Finish on the last step closes onboarding. To send clients somewhere instead:

  1. On the last step, turn on End onboarding at this step. No more steps can be added after it.
  2. Under When the client clicks Finish, choose:
    • Open a link in a new tab: any https:// link, such as a booking page or your help center.
    • Go to a portal page: any page in the client sidebar. If a client doesn't have that page, for example because it's for another engine, they go to their Dashboard instead.

To add more steps later, turn End onboarding at this step off again.

The last step card with "End onboarding at this step" turned on and "When the client clicks Finish" showing the two choices, "Open a link in a new tab" and "Go to a portal page", with a page picked.

Step 6: Check the preview

The Client preview shows a small version of your portal in your saved sidebar order, with the tooltip next to the highlighted page. Use the arrows above it to step through.

  • Engine tabs (Native, Vapi, Retell, ElevenLabs) show what clients on each engine will see. Only engines you have a Pod (an engine or provider connection) for are shown.
  • A callout under the preview lists any steps that are skipped for the selected engine.
  • The last line says what Finish will do.

The buttons in the preview tooltip can't be clicked; they show what clients will see.

The Client preview with a provider tab selected for which one step is skipped: the step counter, the tooltip card with Skip onboarding / Back / Next buttons, and the callout listing the skipped steps.

The preview can't know each client's access permissions. A step can still be skipped for a client whose permissions hide its page.

Step 7: Save

Click Save at the top of the page. You'll see "Onboarding saved. Client users who haven't completed it will see this version on their next sign-in." Discard throws away your unsaved changes.

To turn onboarding off, remove every step and save. You'll see "Onboarding is off. Clients won't see onboarding until you add a step."

Clients who have already finished or skipped onboarding won't see your changes. There's no way to show it to them again.

Test it as a client

Logging in as a client from your agency account never shows onboarding and never marks it complete, so you can preview a client's portal safely. To see the tour itself, sign in to the portal as a new client user (for example, a test user you add to a test client). See Add and Manage Client Users.

Troubleshooting

Check these, in order:

  • Did you save at least one step? An empty onboarding is off.
  • Is the client on a phone, or using the portal embedded in another site? Onboarding doesn't run there.
  • Do any of your steps apply to them? If every step's page is missing from their sidebar (because of their engine, permissions or hidden pages), onboarding doesn't start.
  • Had they already finished or skipped it? It only shows once per client user.
  • Were they already signed in when you saved? They'll see it after they sign in again.

A step is missing something. Look for the red message on the step cards: usually a missing title or description (in English or another language), text over the limit, or a step with no page. Check the language chips too; a badge means that language still has missing text.

The page was deleted, usually a custom page. Choose another page for the step, or remove it.

No. Once a client user has finished or skipped it, it won't show for them again. New client users will see your latest version.