docs: partner pages follow the partner release (Programs, Payout, Referrals, username, invite by email)

content/changelog/refer-program.mdx

@@ -7,6 +7,6 @@ surfaces: [marketplace, dashboard]
 description: Partners promote Affitor itself through the Refer Program and earn rewards and a share of the platform fee from the brands they bring.
 ---
 
-Affitor has its own affiliate program. Find the **Refer Program** in the marketplace, read the official terms on its landing page, and share your link. You earn $50 when a brand you referred goes live, $350 when its program reaches $10,000 in tracked sales, and 15% of the platform fee it pays for 12 months.
+Affitor has its own affiliate program. Find the **Refer Program** in the marketplace, read the official terms, and share your link. You earn $50 when a brand you referred goes live, $350 when its program reaches $10,000 in tracked sales, and 15% of the platform fee it pays for 12 months.
 
 [Read the Refer Program terms](https://affitor.com/legal/refer-program)

content/docs/partners/account-settings.mdx

@@ -2,10 +2,10 @@
 title: "Account and Payout Settings"
 description: "Manage your profile, security, and the payout details that decide how you get paid."
 kind: guide
-last_updated: 2026-10-12
+last_updated: 2026-10-16
 ---
 
-Your account settings hold two things that matter: how advertisers see you, and how your money reaches you. This page walks through both so nothing blocks a payout when you've earned one.
+Your account settings hold two things that matter: how brands see you, and how your money reaches you. This page walks through both so nothing blocks a payout when you've earned one.
 
 <PageMeta
   items={[
@@ -18,36 +18,40 @@ Your account settings hold two things that matter: how advertisers see you, and
 
 ## Profile
 
-Your profile is what an advertiser sees when they review your application. Open **Settings → Account** to edit:
+Your profile is what a brand sees when they review your application. Open **Settings** (from the menu at the top of the left rail, or **Profile** in your account menu), then **Account**:
 
-- **Display name and avatar** — the identity shown to advertisers and on your partner pages. A real name and photo help your applications get approved.
-- **Bio and links** — where you'll promote (site, social, newsletter). Advertisers running manual review use this to decide, so a specific, honest description converts better than a blank field.
+- **Upload image** and **Full name**: the identity shown to brands. A real name and photo help your applications get approved.
+- **Email**: your sign-in email, shown read-only.
+- **Username**: your Refer a brand link, `affitor.com/r/<username>` (see below).
+- **Country**, **Website** and your **YouTube**, **X (Twitter)**, **Instagram**, **TikTok** and **LinkedIn** links: where you promote. Brands running manual review use these to decide.
 
-A complete profile is the single cheapest way to raise your approval rate — advertisers approve partners they can size up.
+**Save changes** saves the whole page, the username included.
 
-## Security
+A complete profile is the single cheapest way to raise your approval rate: brands approve partners they can size up.
+
+### Username
 
-Under **Settings → Security**:
+Your username makes your Refer a brand link `affitor.com/r/<username>`. Use 3-48 lowercase letters, numbers and single dashes; the field checks right away whether the name is free and can suggest one. Your first username is free, then you can change it 3 times. Old links keep working for you: every username you saved, and your original code, still credit you.
 
-- **Change your password** — set a strong, unique one.
-- **Sign-in email** — the address tied to your account and used for important notifications, including payout confirmations.
+## Security
 
-Keep the email current: it's where account and payout alerts land.
+Under **Settings** → **Security**, change your password with **Current password**, **New password** and **Confirm new password**, then **Update password**. Changing it signs you out everywhere else. If you signed up with Google, **Set a password** lets you also sign in with your email address.
 
 ## Payout details
 
-This is the part that blocks money if it's missing. Before your first withdrawal, set your payment method under the **Payout** tab (see [Getting paid](/docs/partners/payouts) for the full flow):
+This is the part that blocks money if it's missing. Before your first withdrawal, add a payout method under **Settings** → **Payout** (see [Getting paid](/docs/partners/payouts) for the full flow):
 
-- Choose your payout method and enter its details accurately — a typo in a payout address is the most common reason a withdrawal fails.
+- **Payout method**: where Affitor sends your earnings when you withdraw. **Add payout method** adds one; **⋯** → **Edit** or **Remove** changes a saved one. Enter the details accurately: a typo in a payout address is the most common reason a withdrawal fails.
+- **Invoice details**: **Business name**, **Address** and **Postal code**, added to your payout invoices.
 
 ## Verify it worked
 
 <VerifySuccess
-  dashboard={["Your profile shows your display name and avatar, and an advertiser reviewing your application sees the same", "The Payout tab shows a saved payment method with no 'add a method' prompt remaining"]}
-  ifNotWorking={["If a withdrawal is blocked, re-open the Payout tab and check that a payment method is saved and that the amount is within your available balance. Pending withdrawals and commissions still awaiting the brand's payment are not available yet"]}
+  dashboard={["Your profile shows your full name and photo, and a brand reviewing your application sees the same", "Settings › Payout lists your payout method instead of \"No payout method yet\""]}
+  ifNotWorking={["If a withdrawal is blocked, open Settings › Payout and check that a payout method is saved, and that the amount is within your available balance. Pending withdrawals and commissions still awaiting the brand's payment are not available yet"]}
 />
 
 ## Next steps
 
-- [Getting paid](/docs/partners/payouts) — turn your balance into a withdrawal
-- [Promote your link and earn](/docs/partners/quickstart/promote-your-link) — drive the commissions in the first place
+- [Getting paid](/docs/partners/payouts): turn your balance into a withdrawal
+- [Promote your link and earn](/docs/partners/quickstart/promote-your-link): drive the commissions in the first place

content/docs/partners/dashboard.mdx

@@ -1,40 +1,58 @@
 ---
 title: "Your Partner Dashboard"
-description: "Where to find your programs, performance, referred customers, and earnings."
+description: "Where to find your programs, each program's numbers and links, your Refer a brand referrals, messages, and your payouts."
 kind: reference
-last_updated: 2026-06-08
+last_updated: 2026-10-16
 ---
 
-Your dashboard has three tabs — **Home**, **Marketplace**, and **Payout** — plus deeper views for performance and customers. Here's what each one shows.
+The partner dashboard has four sections in the left menu: **Programs**, **Marketplace**, **Referrals** and **Payout**. **Messages** is the message icon in the top bar (a menu row on phones). This page shows what each one holds.
 
-## Home
+## Programs
 
-Your main view. It lists the programs you've joined with the numbers that matter:
+**Programs** is your partner home. It lists the programs you joined or applied to:
 
 | Column | What it means |
 | --- | --- |
+| **Status** | Active, or Pending while the brand reviews your application |
 | **Clicks** | Visits through your referral links |
 | **Signups** | Referred users who created an account |
 | **Paid Signups** | Referred users who became paying customers |
 | **Revenue** | Sales attributed to you |
 | **Total Commission** | What you've earned |
 
-Programs you've applied to but aren't approved for yet appear here too, with a status badge.
+**Search programs** and the **All** / **Active** / **Pending** filter narrow the list; the table footer shows how many programs you have. **Find programs** opens the Marketplace. On a pending application, **⋯** → **Withdraw application** removes it; you can apply again later from the Marketplace.
 
-## Performance
+Until your partner setup is done, a **Finish setup** card above the list shows how many of its three steps are done and a **Continue:** button naming the next one.
 
-The **Performance** view breaks results down per program: total revenue, total commissions, total clicks, and your conversion rate.
+## A program's page
 
-## Analytics
+Select a program to open its page. At the top, **Copy link** copies your referral link and **Message** opens a conversation with the brand. The page has four tabs:
 
-The **Analytics** view rolls everything up across programs — clicks, leads, conversions, revenue, commissions, conversion rate, and average order value.
+| Tab | What it shows |
+| --- | --- |
+| **Overview** | **Clicks**, **Signups**, **Paid signups**, **Revenue** and **Commission** for **7d**, **30d**, **90d** or **All**, a chart, and your **Top links** |
+| **Links** | Every link you made for this program with its clicks, signups, paid signups and revenue. **Create link** adds another |
+| **Customers** | The people you referred: **Customer** (masked email and signup date), **Last purchase** and **Lifetime value** |
+| **Commissions** | Each commission with its **Date**, **Type**, **Link**, **Sale**, **Commission** and **Status** (such as **Pending**, **Approved**, **Paid**, **Rejected** or **Refunded**) |
+
+## Marketplace
+
+The **Marketplace** lists the programs you can join. Each card has **Apply**, or shows **Joined** or **Applied**. See [Find and join programs](/docs/partners/quickstart/find-and-join-programs).
+
+## Referrals
 
-## Customers
+**Referrals** is the page for the Affitor Refer Program: your link for referring brands to Affitor, **Invite via email**, the brands you referred with their stage, and your **Earnings** (**On hold**, **Released**, **Lifetime**) with **Withdraw** and **Payout history**. See [Refer a brand to Affitor](/docs/partners/quickstart/get-your-referral-link#refer-a-brand-to-affitor) and [How referral rewards work](/docs/partners/referral-rewards).
 
-The **Customers** view lists the people you've referred: their email, location, total spent, commission earned, and referral date.
+## Messages
+
+**Messages** holds your conversations with brands. **New message** starts one with any program. While your application to a program is pending, you can send it 3 messages until the brand answers.
 
 ## Payout
 
-The **Payout** tab is where you set up payment and withdraw earnings. It's covered next.
+**Payout** shows your balance and **Payout history**, and **Withdraw** opens the withdrawal. It's covered next.
+
+## Settings
+
+Open the menu at the top of the left rail and choose **Settings**, or open **Profile** from your account menu. See [Account and payout settings](/docs/partners/account-settings).
 
-<NextStep title="Getting paid" description="Set up a payment method and withdraw your earnings." href="/docs/partners/payouts" />
+<NextStep title="Getting paid" description="Set up a payout method and withdraw your earnings." href="/docs/partners/payouts" />

content/docs/partners/faq.mdx

@@ -2,7 +2,7 @@
 title: "Partner FAQ"
 description: "Common questions about joining programs, referral links, tracking, and getting paid."
 kind: faq
-last_updated: 2026-10-14
+last_updated: 2026-10-16
 ---
 
 ## Getting started
@@ -11,10 +11,10 @@ last_updated: 2026-10-14
 Browse the **[Marketplace](https://affitor.com/marketplace)**. It's public, so you can look before you log in. To apply, you'll need a partner account.
 
 ### Why don't I see any programs after signing up?
-Make sure you verified your email and chose the **Partner** role. Both are required before the Marketplace and applications unlock. See [Create your account](/docs/partners/quickstart/create-account).
+Make sure you verified your email and chose **Join programs**. Both are required before the Marketplace and applications unlock. See [Create your account](/docs/partners/quickstart/create-account).
 
 ### Do I need to write a pitch to apply?
-No. Applying is one click — the *"Why do you want to join?"* message is optional.
+No. Applying is one click: the **How will you promote it?** field is optional.
 
 ## Approval and links
 
@@ -25,17 +25,17 @@ It depends on the program. **Auto-accept** programs approve you instantly. **Man
 You can apply to other programs in the Marketplace anytime — there's no limit on how many you join.
 
 ### Where is my referral link?
-It's created for you automatically when you're approved for the program. Open the program from your dashboard and look for the **Copy** button in your links table. See [Get your referral link](/docs/partners/quickstart/get-your-referral-link).
+It's created for you automatically when you're approved for the program. Open the program from **Programs** and select **Copy link**. See [Get your referral link](/docs/partners/quickstart/get-your-referral-link).
 
 ### How is a click credited to me?
-Your link carries a unique code, as `?aff=` or `/r/` depending on the brand's setup. Affitor stores it in a first-party cookie on click and ties later signups and sales back to you.
+Your link carries a unique code, as `?via=`, `?aff=` or `/r/` depending on the brand's setup. Affitor stores it in a first-party cookie on click and ties later signups and sales back to you.
 
 ## Getting paid
 
 ### How do I get paid?
-Add a payment method under **Profile → Payout**, then withdraw from the **Payout** tab when you have an available balance. See [Getting paid](/docs/partners/payouts).
+Add a payout method under **Settings** → **Payout**, then withdraw from the **Payout** page when you have an available balance. See [Getting paid](/docs/partners/payouts).
 
-### What payment methods can I use?
+### What payout methods can I use?
 Bank transfer (ACH in the US, BIC/SWIFT internationally) or Wise, depending on your country and currency.
 
 ### Is there a minimum payout?

content/docs/partners/index.mdx

@@ -2,15 +2,15 @@
 title: "Become a Partner"
 description: "Join a SaaS affiliate program on Affitor, get your referral link, and start earning commission."
 kind: concept
-last_updated: 2026-10-15
+last_updated: 2026-10-16
 ---
 
 Partners promote SaaS products and earn commission on the customers they refer. This guide takes you from a brand-new account to your first shareable referral link.
 
 > **Key terms:**
-> - **Partner** — you: the affiliate, creator, agency, or promoter sending traffic
-> - **Advertiser** — the SaaS company whose program you join
-> - **Referral link** — your unique tracked URL; every click and sale through it is credited to you
+> - **Partner**: you: the affiliate, creator, agency, or promoter sending traffic
+> - **Brand**: the SaaS company whose program you join
+> - **Referral link**: your unique tracked URL; every click and sale through it is credited to you
 
 ## Your path to earning
 

content/docs/partners/payouts.mdx

@@ -1,25 +1,25 @@
 ---
 title: "Getting Paid"
-description: "How commissions turn into a payout — balances, payment methods, withdrawal, and timing."
+description: "How commissions turn into a payout: balances, payout methods, withdrawal, and timing."
 kind: guide
-last_updated: 2026-10-14
+last_updated: 2026-10-16
 ---
 
-This page covers the money: how your commission becomes a balance, how to set up a payment method, and how to withdraw.
+This page covers the money: how your commission becomes a balance, how to set up a payout method, and how to withdraw.
 
 ## Your balance
 
-The **Payout** tab shows three numbers:
+The **Payout** page shows three numbers:
 
-- **Ready to withdraw** — the available balance you can cash out now
-- **Pending** — earned but not yet cleared for withdrawal
-- **Total paid** — your lifetime earnings paid out
+- **Ready to withdraw**: the available balance you can cash out now
+- **Pending**: earned but not yet cleared for withdrawal
+- **Total paid**: your lifetime earnings paid out
 
-An approved commission is added to your balance, but you can withdraw it only once the brand has paid the invoice that covers it. Until then it shows under **Ready to withdraw** as **Awaiting brand payment**. Commissions approved before October 9, 2026, 00:00 Pacific time (07:00 UTC) became withdrawable on approval.
+An approved commission is added to your balance, but you can withdraw it only once the brand has paid the invoice that covers it. Until then it shows on its own line, **Awaiting brand payment**, below **Ready to withdraw**. Commissions approved before October 9, 2026, 00:00 Pacific time (07:00 UTC) became withdrawable on approval.
 
-## 1. Set up a payment method
+## 1. Set up a payout method
 
-Before you can withdraw, add a payment method under **Profile → Payout**. Enter your country, currency, and account details.
+Before you can withdraw, add a payout method under **Settings** → **Payout** with **Add payout method**. Pick the **Recipient country**, **Recipient currency** and **Type**, then enter the account details.
 
 Available methods depend on your country and currency:
 
@@ -32,11 +32,13 @@ Available methods depend on your country and currency:
 
 ## 2. Withdraw
 
-Open **Withdraw** from the Payout tab. It's a three-step wizard:
+Select **Withdraw** on the **Payout** page (or under **Earnings** on **Referrals**). It is turned off while less than $10 is ready. The withdrawal has three steps:
 
-1. **Amount** — enter how much to withdraw, pick your method, and see any processing fee
-2. **Review** — confirm the details
-3. **Pay** — submit your withdrawal
+1. **Amount**: enter how much to withdraw. **To** shows your payout method (**Change** appears when you have more than one), and **Estimated fees** shows any processing fee
+2. **Review**: check the details under **Confirm your withdrawal**, then select **Confirm** to submit it
+3. **Pay**: the confirmation, with the net amount and fees
+
+With no payout method yet, the Amount step says so and **Go to Settings** opens **Settings** → **Payout**.
 
 :::note
 
@@ -46,10 +48,10 @@ A processing fee may apply depending on the method; the exact amount is shown be
 
 ## 3. When you get paid
 
-After you submit a withdrawal, the Affitor team reviews it and marks it as sent. Once it's sent, how long the funds take to reach your account depends on your bank or Wise. You can follow the status — pending → processing → completed — in your payout history.
+After you submit a withdrawal, the Affitor team reviews it and marks it as sent. Once it's sent, how long the funds take to reach your account depends on your bank or Wise. You can follow the status (pending, processing, completed) in **Payout history** on the **Payout** page. Search it, filter by status or type, and **Export** it as CSV; **⋯** → **View details** opens **Transaction details** with the timeline of that payout or commission.
 
 ## After a refund
 
-If a sale is later refunded, the related commission is reversed: before it is approved it never reaches your balance, and after approval the amount is deducted from your balance. If you had already withdrawn that commission, your balance can go negative: the Payout tab shows it as **Balance owed**, and it is recovered from your next commissions.
+If a sale is later refunded, the related commission is reversed: before it is approved it never reaches your balance, and after approval the amount is deducted from your balance. If you had already withdrawn that commission, your balance can go negative: the **Payout** page shows it as **Balance owed**, and it is recovered from your next commissions.
 
 <NextStep title="Partner FAQ" description="Quick answers to the most common partner questions." href="/docs/partners/faq" />