> ## Documentation Index
> Fetch the complete documentation index at: https://docs.introw.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Build a progressive onboarding path

> Plan onboarding stages, create a dynamic segment per stage, gate portal tabs, sections, and abilities to those segments, and let journeys move partners forward so the portal unlocks as partners qualify.

{/* Progressive onboarding is not a single setting; it is a pattern you assemble from three pieces
  that already exist: dynamic segments decide which stage a partner has reached, the experience
  gates tabs and sections to those segments, and journeys give partners the checklist that moves
  them forward. This guide walks the whole build end to end, from planning the stages to publishing,
  so a partner sees only their current stage and the next one appears the moment they qualify. */}

## What you'll achieve

A portal that unlocks stage by stage on its own: a dynamic segment per onboarding stage, tabs, sections, and abilities gated to those segments, and a journey driving partners forward. Partners graduate automatically as they qualify, with no manual access grants.

## Before you start

<Steps>
  <Step title="Confirm access and setup">
    You need permission to create segments and edit experiences, a published portal experience partners can reach, and a connected CRM so dynamic segments can filter on live partner data.
  </Step>

  <Step title="Know your milestones">
    Identify the signal that promotes a partner into each stage, such as a completed journey, a certificate, a tier, or a CRM property value.
  </Step>
</Steps>

## Watch it

<Tabs>
  <Tab title="Video">
    <video controls playsInline preload="none" poster="https://assets.introw.io/docs/features/partners/onboarding/guides/build-a-progressive-onboarding-path/steps/01.png?v=1783332265" className="w-full rounded-xl" src="https://assets.introw.io/docs/features/partners/onboarding/guides/build-a-progressive-onboarding-path/video.webm?v=1783332265#t=2.5" />
  </Tab>

  <Tab title="Click through">
    <iframe className="w-full rounded-xl" style={{ width: "100%", aspectRatio: "16 / 11", border: 0, backgroundColor: "#FAFAFA" }} src="https://assets.introw.io/docs/features/partners/onboarding/guides/build-a-progressive-onboarding-path/walkthrough.html?v=1783332265" />
  </Tab>
</Tabs>

## Steps

### Plan the stages

<Steps>
  <Step title="List the stages">
    Decide the stages a partner passes through, for example Welcome, Trained, Selling, and Established. Keep them few enough that each one is a meaningful step up.

    <Frame>
      <img src="https://assets.introw.io/docs/features/partners/onboarding/guides/build-a-progressive-onboarding-path/steps/01.png?v=1783332265" alt="List the stages" />
    </Frame>
  </Step>

  <Step title="Decide what each stage unlocks">
    For each stage, list the tabs, asset sections, and abilities (forms, deal registration, courses) that should become available. This is the reward a partner earns by reaching the stage.

    <Frame>
      <img src="https://assets.introw.io/docs/features/partners/onboarding/guides/build-a-progressive-onboarding-path/steps/03.png?v=1783332265" alt="Decide what each stage unlocks" />
    </Frame>
  </Step>

  <Step title="Pick the promotion milestone">
    For each stage, choose the single measurable condition that promotes a partner into it, so it can become a dynamic segment filter. One clear condition per stage keeps advancement predictable.

    <Frame>
      <img src="https://assets.introw.io/docs/features/partners/onboarding/guides/build-a-progressive-onboarding-path/steps/04.png?v=1783332265" alt="Pick the promotion milestone" />
    </Frame>
  </Step>
</Steps>

### Create a segment per stage

<Steps>
  <Step title="Open Segments">
    Go to [Segments](https://app.introw.io/settings/segments) and create a **dynamic** segment for each stage. A dynamic segment recomputes its membership from filters, which is what makes graduation automatic.

    <Frame>
      <img src="https://assets.introw.io/docs/features/partners/onboarding/guides/build-a-progressive-onboarding-path/steps/05.png?v=1783332265" alt="Open Segments" />
    </Frame>
  </Step>

  <Step title="Set the qualifying filter">
    On the segment's **Audience** tab, add the filter that defines the stage, such as a tier reached, a certificate earned, an onboarding journey complete, or a CRM property value. Membership then tracks that milestone, so partners enter the segment the moment they qualify. Stage filters do not need to exclude earlier stages: a partner in a later stage usually still matches the earlier segments, and that is safe, because when a contact belongs to several segments the most permissive settings win and every stage they have earned keeps adding up.

    <Frame>
      <img src="https://assets.introw.io/docs/features/partners/onboarding/guides/build-a-progressive-onboarding-path/steps/06.png?v=1783332265" alt="Set the qualifying filter" />
    </Frame>
  </Step>

  <Step title="Check the audience preview">
    Use the audience preview to confirm the partners who currently match are the ones you expect, before any gating depends on the segment.

    <Frame>
      <img src="https://assets.introw.io/docs/features/partners/onboarding/guides/build-a-progressive-onboarding-path/steps/07.png?v=1783332265" alt="Check the audience preview" />
    </Frame>
  </Step>
</Steps>

### Gate the experience

<Steps>
  <Step title="Open the experience">
    Go to [Experiences](https://app.introw.io/templates) and open the experience partners use.

    <Frame>
      <img src="https://assets.introw.io/docs/features/partners/onboarding/guides/build-a-progressive-onboarding-path/steps/08.png?v=1783332265" alt="Open the experience" />
    </Frame>
  </Step>

  <Step title="Restrict tabs to stage segments">
    On a stage's tab, restrict it to the segment for that stage so only partners who have reached it see the tab. A tab restricted to a segment is invisible to everyone else, which is the core of progressive unlocking.

    <Frame>
      <img src="https://assets.introw.io/docs/features/partners/onboarding/guides/build-a-progressive-onboarding-path/steps/09.png?v=1783332265" alt="Restrict tabs to stage segments" />
    </Frame>
  </Step>

  <Step title="Gate sections and abilities">
    Within a visible tab, restrict individual sections to a segment when only later-stage partners should see them. Do the same for ability-bearing sections such as asset libraries, forms, and deal registration, so later stages unlock real capability, not just more pages.
  </Step>

  <Step title="Tune stage permissions">
    On each stage segment, set **Permissions** so a stage can unlock abilities like inviting teammates or collaboration scope, not just content. These live on the segment itself, see [Create a dynamic segment](/features/partners/segments/guides/create-a-dynamic-segment) for the permission options. Configure only what each stage grants: permissions and notifications resolve to the most permissive across a contact's segments, so a stage can never take back what an earlier one gave. Put your restricted floor on a default segment that captures everyone, see [Layer segments to progressively unlock capabilities](/features/partners/segments/guides/layer-segments-to-progressively-unlock).
  </Step>
</Steps>

### Drive partners forward and publish

<Steps>
  <Step title="Apply an onboarding journey">
    Give partners an onboarding journey so they always have a concrete next step. As they complete it and hit the milestones your segments key on, they roll into the next stage's segment and the matching tabs unlock. See [Build a journey from scratch](/features/partners/journeys/guides/build-a-journey-from-scratch).
  </Step>

  <Step title="Preview by stage">
    Preview the experience as partners in different stages to confirm each sees only their unlocked tabs, sections, and abilities. Catching an over-broad segment here avoids exposing content to the wrong partners.
  </Step>

  <Step title="Publish">
    Publish the experience to push the gating to linked partner portals. From here, unlocking happens on its own as segment membership updates.
  </Step>
</Steps>

## Verify it worked

A partner in an early stage sees only their tabs, sections, and abilities. When a test partner meets a stage's milestone, they join that stage's segment and the matching content unlocks for them with no manual step.

## Related

<CardGroup cols={2}>
  <Card title="Create a dynamic segment" icon="book-open" href="/features/partners/segments/guides/create-a-dynamic-segment">
    Build the auto-updating audience and set its permissions.
  </Card>

  <Card title="Layer segments to progressively unlock capabilities" icon="book-open" href="/features/partners/segments/guides/layer-segments-to-progressively-unlock">
    How overlapping segments resolve, and why stages only ever add.
  </Card>

  <Card title="Build a journey from scratch" icon="book-open" href="/features/partners/journeys/guides/build-a-journey-from-scratch">
    Give partners the checklist that moves them forward.
  </Card>

  <Card title="Assign a journey and track progress" icon="book-open" href="/features/partners/journeys/guides/assign-a-journey-and-track-progress">
    Apply the journey and watch partners advance.
  </Card>

  <Card title="Implementation reference" icon="screwdriver-wrench" href="../technical">
    Full configuration options for progressive onboarding.
  </Card>
</CardGroup>
