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

# Partner portal overview

> How the partner portal works — how partners access it, and the login methods available for affiliate and refer-a-friend programs

Every program includes a **partner portal** — the hosted, white-label dashboard where your partners (affiliates) or members (refer-a-friend) log in to track performance, grab referral links, and manage payouts. This guide explains how partners reach the portal and how they sign in.

<CardGroup cols={2}>
  <Card title="Login methods" icon="right-to-bracket" href="#login-methods">
    One-time codes, passwords, and Google login.
  </Card>

  <Card title="Embedding the portal" icon="window-maximize" href="/guides/partner-portal/embedding">
    Show the portal inside your own website.
  </Card>

  <Card title="Prefill the login email" icon="envelope" href="/guides/partner-portal/prefill-login-email">
    Skip re-entering the email on login.
  </Card>

  <Card title="Custom domain" icon="globe" href="#accessing-the-portal">
    Serve the portal from your own domain.
  </Card>
</CardGroup>

## Accessing the portal

Each program's portal is served from its **own hostname**, not a shared path. There are two options:

| Option                | URL                                    | When it applies                                                                                              |
| --------------------- | -------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| **Default subdomain** | `https://your-program.partner.example` | Every program gets one automatically. The base domain differs for affiliate vs. refer-a-friend portals.      |
| **Custom domain**     | `https://partners.yourdomain.com`      | When you connect and verify a custom (sub)domain for the program. Takes priority over the default subdomain. |

<Note>
  A verified, active **custom domain** is required for some features — most notably the [embeddable portal widget](/guides/partner-portal/embedding). Without one, the portal is still fully usable at its default subdomain.
</Note>

## Portal pages

Once signed in, partners have access to pages such as:

* **Dashboard** — performance summary
* **Referral links** and promotional resources
* **Referrals / leads** — who they've referred
* **Payouts and reports** (affiliate programs)
* **Profile and messages**

The exact set of pages depends on the program type (affiliate portals are richer; refer-a-friend portals are focused on the dashboard).

## Login methods

The portal decides which sign-in options to show based on the **program type** and your **portal settings**.

### Affiliate programs

<CardGroup cols={2}>
  <Card title="Password" icon="key">
    The default. Partners sign in with email + password.
  </Card>

  <Card title="One-time code (passwordless)" icon="hashtag">
    Optional. Partners receive a short numeric code by email instead of using a password.
  </Card>

  <Card title="Google login" icon="google">
    Optional. Adds a "Continue with Google" button.
  </Card>

  <Card title="Sub-account login" icon="users">
    Optional. When sub-accounts are enabled, team members get their own login.
  </Card>
</CardGroup>

Enable these under **Program → Portal → Settings**. When passwordless login is on, the password form is replaced by the one-time-code flow.

### Refer-a-friend programs

Refer-a-friend portals **always use one-time email codes** — there is no password or Google option. Members enter their email, receive a code, and enter it to sign in.

## How one-time code login works

1. The partner enters their email and requests a code.
2. Partnero emails a short **numeric code** (it is a code to type in, not a clickable magic link).
3. The partner types the code into the portal and lands on their dashboard.

<Info>
  Codes are entered manually. On iOS, the emailed code is offered as a keyboard autofill suggestion and fills the code boxes automatically.
</Info>

## Bot protection

If **Cloudflare Turnstile** is enabled for the portal, the login form requires the challenge to be solved before it submits. This also applies when [auto-submitting a prefilled login](/guides/partner-portal/prefill-login-email) — auto-submit waits for the challenge to complete.

## Next steps

<CardGroup cols={2}>
  <Card title="Embed the portal" icon="window-maximize" href="/guides/partner-portal/embedding">
    Add the portal to your own site with the in-site widget.
  </Card>

  <Card title="Prefill the login email" icon="envelope" href="/guides/partner-portal/prefill-login-email">
    Reduce login friction for known users.
  </Card>
</CardGroup>