Skip to content

docs: rewrite referral program guide with rewards and screenshots#132

Merged
yabirgb merged 2 commits into
rotki:mainfrom
kelsos:docs/referral-program-update
Jul 1, 2026
Merged

docs: rewrite referral program guide with rewards and screenshots#132
yabirgb merged 2 commits into
rotki:mainfrom
kelsos:docs/referral-program-update

Conversation

@kelsos

@kelsos kelsos commented Jul 1, 2026

Copy link
Copy Markdown
Member

Summary

Rewrites the referral program documentation to match the current implementation in rotki.com. The previous guide was out of date on several key points.

Corrections

  • Referrer rewards are live. Referrers now earn account credit (applied automatically to their renewals/upgrades), replacing the old "benefits coming soon" text.
  • Eligibility fixed. Creating a referral code only requires a confirmed email, not an active premium subscription.
  • Sharing flow documented. The primary path is a share link (/products?ref=CODE) that auto-applies the discount via a 30-day cookie, plus the built-in share buttons (X, Farcaster, Bluesky, WhatsApp, Email) and manual entry as a fallback.

Additions

  • Rules and Limitations: first-payment-only, one code per checkout (no stacking), cannot use your own code, no referral codes on upgrades, usage limit/expiry.
  • Account Credit section added to the subscription guide, with the credit usage disclaimer (non-refundable, non-transferable).
  • Reworked troubleshooting to match actual behavior.
  • Three screenshots (referral code section, checkout with referral applied, populated account credit).

Notes

  • Amounts are kept generic in prose since they are backend/API-driven; a "screenshots are examples" disclaimer covers the specific values baked into the images.
  • Verified end-to-end against a live instance.

Files

  • premium/referrals.md — full rewrite
  • premium/subscription.md — fixed stale referral line, added Account Credit section
  • public/images/referrals/*.webp — three new screenshots

Update the referral documentation to match the current implementation
in rotki.com and rotkehlchen-web:

- Referrer rewards are live (account credit), not "coming soon"
- Creating a code only requires a confirmed email, not an active subscription
- Document the share-link auto-apply flow, share channels, and manual entry
- Add rules (first-payment-only, no stacking, no own-code, no upgrades,
  usage limit/expiry) and rework troubleshooting
- Keep amounts generic (API-driven) with a "screenshots are examples" note
- Add an Account Credit section to the subscription guide with the
  credit usage disclaimer
- Add three screenshots (referral code, checkout, account credit)
Comment thread premium/referrals.md Outdated
Address review feedback: account credit is applied to new subscription
purchases as well as renewals and upgrades, matching the backend.

@yabirgb yabirgb left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm

@yabirgb yabirgb merged commit 27c46cb into rotki:main Jul 1, 2026
5 checks passed
@kelsos kelsos deleted the docs/referral-program-update branch July 1, 2026 11:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants