Growth engineering

01What is it?
Activate this skill when the user's request involves any of the following. Its edge is a particular angle on growth marketing, giving the agent tighter constraints than a plain growth engineering request.
02Inputs
Context for growth marketing: your goals, audience, constraints, and any source material the skill asks for.
03Output
A ready-to-use result for growth marketing: the analysis, copy, or recommendations the agent produces.
Install-only

Install as a package

Installs this one skill package for your coding agent, including any supporting files that skill ships with — not every skill in the repository. Read the tutorial.

Terminal
$ npx skills add indranilbanerjee/digital-marketing-pro --skill growth-engineering

Skill instructions

The instruction file for this skill. The skill also includes other files you need to install to use it.

SKILL.md

Growth Engineering

When to Use This Skill

Activate this skill when the user's request involves any of the following:

  • Designing or improving a product-led growth (PLG) motion
  • Building or optimizing referral programs (customer referral, partner referral, ambassador programs)
  • Creating viral loops or increasing organic sharing mechanics
  • Planning a product or company launch (Product Hunt, beta launches, waitlists)
  • Improving user retention, reducing churn, or designing re-engagement campaigns
  • Running growth experiments and building an experimentation culture
  • Setting up or optimizing affiliate marketing programs
  • Designing activation flows and reducing time-to-value for new users
  • Building growth models or forecasting viral growth coefficients
  • Solving cold-start problems for marketplaces or platforms
  • Identifying and scoring product-qualified leads (PQLs)
  • Any question about growth levers, growth loops, or sustainable acquisition strategies

Brand Context (Auto-Applied)

Before producing any marketing output from this module:

  1. Check session context — The active brand summary was output at session start. Use the brand name, industry, voice settings, channels, goals, compliance, and competitors shown there.
  2. If you need the full profile, read: ~/.claude-marketing/brands/{slug}/profile.json
  3. Apply brand voice — Formality, energy, humor, authority levels must shape all content tone and word choices
  4. Check compliance — Auto-apply rules for brand's target_markets and industry using skills/context-engine/compliance-rules.md
  5. Reference industry benchmarks — Consult skills/context-engine/industry-profiles.md for the brand's industry
  6. Use platform specs — Reference skills/context-engine/platform-specs.md for character limits and format requirements
  7. Check campaign history — Run python "${CLAUDE_PLUGIN_ROOT}/scripts/campaign-tracker.py" --brand {slug} --action list-campaigns before planning new work
  8. If no brand exists, say: "No brand profile found. Use /digital-marketing-pro:brand-setup to create one, or I can proceed with general best practices."
  9. Check brand guidelines — If ~/.claude-marketing/brands/{slug}/guidelines/_manifest.json exists, load and enforce: restrictions.md for banned words, restricted claims, and mandatory disclaimers; channel-styles.md for channel-specific tone overrides (may differ from base voice); messaging.md for approved key messages, taglines, and positioning language; voice-and-tone.md for detailed voice rules beyond the 4 numeric scores. If producing content for a specific channel, channel style rules take precedence over base voice settings.

Do not ask the user for information that already exists in their brand profile.

Required Context

Before executing, gather the following from the user (ask if not provided):

  • Product type: SaaS, marketplace, ecommerce, mobile app, content platform, service business
  • Business model: Subscription, transactional, freemium, free-trial, advertising-supported
  • Current stage: Pre-launch, early traction (under 1,000 users), growth stage, scale stage
  • Key metrics: Current MRR/ARR, user count, activation rate, retention rate, churn rate, NPS
  • Existing growth channels: Which acquisition channels are active and their relative performance
  • Viral potential: Whether the product has inherent sharing mechanics or requires artificial virality
  • Team and resources: Engineering capacity for growth features, marketing budget, partnership resources
  • Target user: Who the ideal user is and what their primary motivation for using the product is
  • Competitive landscape: Key competitors and their growth strategies

Capabilities

Product-Led Growth (PLG) Strategy

  • Free-to-paid conversion: Freemium model design, free trial optimization, feature gating strategy, usage-based pricing triggers
  • Activation metrics: Define the "aha moment," map the steps to reach it, measure and optimize activation rate
  • Time-to-value optimization: Reduce friction between signup and first value experience through onboarding design, templates, sample data, and guided tours
  • PQL scoring: Define product-qualified lead criteria based on usage patterns, feature adoption, team size, and engagement frequency
  • Self-serve expansion: In-product upgrade prompts, usage limit notifications, team invite flows, seat expansion triggers
  • Reverse trial: Give full access first, then downgrade to free -- when this works better than traditional freemium

Referral Systems

  • Give-and-get programs: Both referrer and referee receive incentives (e.g., Dropbox's extra storage model)
  • Tiered referral rewards: Escalating incentives based on number of successful referrals
  • Milestone referrals: Rewards triggered at referral count milestones (1, 5, 10, 25) to maintain momentum
  • NPS-to-referral pipeline: Target promoters (NPS 9-10) with referral requests at the moment of highest satisfaction
  • Double-sided incentive design: Balancing referrer reward (motivation to share) with referee reward (motivation to convert)
  • Referral channel optimization: Email, unique link, social share, in-app invite, SMS -- which channels perform for which product types
  • Fraud prevention: Detecting self-referral, fake accounts, and incentive gaming without creating friction for legitimate referrers

Viral Loop Design

  • Inherent virality: The product naturally requires others to use it (Slack, Zoom, Google Docs)
  • Artificial virality: Manufactured sharing through incentives, social features, or content creation (shareable reports, badges, results)
  • Content virality: User-generated content that surfaces on external platforms and drives new users back
  • Social proof virality: Visible usage signals (badges, signatures, "powered by" links, public profiles)
  • Viral coefficient calculation: K-factor = invites per user x conversion rate of invites. K > 1 means exponential growth; K between 0.5-1.0 augments paid acquisition significantly
  • Viral cycle time: Reducing the time between a user joining and their invitees joining. Shorter cycles compound faster even with lower K-factors

Launch Playbooks

  • Tier 1 launch (major product): Full press campaign, influencer seeding, Product Hunt, beta community, launch event, paid amplification
  • Tier 2 launch (feature/update): Existing user announcement, targeted outreach, community posts, changelog, email campaign
  • Tier 3 launch (minor update): In-app notification, changelog update, social media post
  • Pre-launch waitlist: Viral waitlist mechanics (share to move up), early access incentives, drip content to maintain interest
  • Product Hunt launch: Preparation timeline (2-4 weeks), hunter selection, launch day playbook, post-launch engagement
  • Beta program design: Closed beta recruitment, feedback loops, beta-to-launch transition, early adopter community building

Retention Loops

  • Engagement design: Habit loops (trigger, action, variable reward, investment), notification strategy, content cadence
  • Re-engagement campaigns: Email sequences, push notifications, in-app messages, retargeting ads triggered by inactivity signals
  • Churn prediction: Behavioral signals that indicate churn risk (login frequency drop, feature usage decline, support ticket patterns)
  • Winback sequences: Timed outreach to churned users with personalized value reminders, product updates, and incentive offers
  • Cohort analysis: Track retention by signup cohort, acquisition channel, activation status, and feature adoption to identify what drives long-term retention
  • Expansion revenue: Upsell and cross-sell triggers based on usage patterns, team growth, and feature engagement

Affiliate Marketing

  • Program design: Commission structure (percentage, flat fee, tiered, recurring), cookie duration, attribution rules
  • Network selection: When to use affiliate networks (ShareASale, CJ, Impact) vs building a custom program
  • Affiliate recruitment: Finding high-quality affiliates through competitor analysis, content partnerships, and niche community outreach
  • Commission optimization: Balancing commission rates to attract affiliates while maintaining profitability; performance tiers to reward top performers
  • Fraud detection: Click fraud, cookie stuffing, brand bidding violations, trademark misuse, coupon abuse
  • Content affiliate strategy: Working with bloggers, review sites, comparison sites, and niche publishers
  • Affiliate-influencer hybrids: Creator partnerships with performance-based compensation models

Process

PLG Implementation (Most Common Use Case)

  1. Map the user journey -- Document every step from first awareness to paid conversion. Identify where users currently drop off and where they experience value.
  2. Define the activation metric -- Determine the specific action or combination of actions that correlates with long-term retention. This is the "aha moment" the entire PLG motion revolves around.
  3. Design the free offering -- Structure the free tier or trial to give users enough value to experience the activation moment while creating natural upgrade triggers. Reference common models: feature-limited freemium, usage-limited freemium, time-limited trial, reverse trial.
  4. Optimize time-to-value -- Redesign onboarding to get users to the activation metric as fast as possible. Remove unnecessary steps, add templates/sample data, implement guided tours, and offer quick-start paths.
  5. Build PQL scoring -- Define the behavioral signals that indicate a free user is ready for a sales touch or upgrade prompt. Combine usage frequency, feature breadth, team size, and engagement depth into a composite score.
  6. Implement expansion loops -- Design in-product mechanisms for organic growth: team invites, shared workspaces, public outputs, integrations that touch other teams, and usage-based upgrade paths.
  7. Measure and iterate -- Track activation rate, free-to-paid conversion rate, time-to-activation, expansion revenue, and viral coefficient. Run experiments on each stage of the funnel.

Referral Program Build

  1. Assess viral potential -- Determine whether the product has inherent sharing mechanics or requires incentive-driven referrals. Analyze NPS data to identify promoter concentration.
  2. Design incentive structure -- Choose the referral model (give-and-get, tiered, milestone) based on product type, customer LTV, and competitive benchmarks. Set incentive values at 10-25% of customer acquisition cost.
  3. Build referral mechanics -- Create unique referral links, sharing interfaces, tracking infrastructure, and reward fulfillment flows. Make sharing frictionless (one-click, pre-written messages).
  4. Integrate referral touchpoints -- Embed referral prompts at high-satisfaction moments: post-purchase, after achieving a milestone, after a positive support interaction, at NPS survey completion.
  5. Launch and promote -- Announce the program to existing users, feature it in onboarding, add it to account dashboards, and include it in email communications.
  6. Monitor and optimize -- Track share rate, invite conversion rate, referral revenue, and fraud signals. A/B test incentive types, sharing copy, and prompt placement.

Reference Files

  • product-led-growth.md -- PLG frameworks, freemium vs trial decision trees, activation metric identification, PQL scoring models
  • referral-systems.md -- Referral program templates, incentive design principles, fraud prevention tactics, and case studies
  • viral-loops.md -- Viral coefficient calculations, loop design patterns, virality assessment frameworks
  • launch-strategy.md -- Tier 1/2/3 launch playbooks, Product Hunt guide, waitlist mechanics, beta program design
  • retention-loops.md -- Engagement frameworks, churn prediction models, winback sequences, cohort analysis methods
  • affiliate-marketing.md -- Program setup guides, network comparisons, commission optimization, fraud detection systems

Output Formats

  • PLG strategy document: User journey map, activation metric definition, free tier design, PQL criteria, expansion loop mechanics, and success metrics
  • Referral program spec: Incentive structure, mechanics description, integration points, launch plan, and monitoring dashboard requirements
  • Launch playbook: Pre-launch timeline, launch day checklist, channel-by-channel activation plan, post-launch follow-up sequence
  • Retention analysis: Cohort retention curves, churn risk indicators, re-engagement campaign designs, and winback sequence templates
  • Growth model: Spreadsheet-ready model with viral coefficient, cycle time, channel-level CAC, retention curves, and projected growth trajectories
  • Affiliate program blueprint: Commission structure, network/platform recommendation, recruitment strategy, compliance guidelines, and fraud monitoring plan

Edge Cases

Non-Viral Products

Some products have no inherent sharing mechanic (e.g., personal finance tools, solo productivity apps). For these, create artificial virality through shareable outputs (reports, achievements, results), social proof features (public profiles, leaderboards), content creation tools that naturally surface the brand, or incentive-driven referrals. Not every product needs a viral coefficient above 1 -- even K=0.3 meaningfully reduces CAC.

Marketplace Cold-Start Problem

Two-sided marketplaces face the chicken-and-egg problem: no supply without demand, no demand without supply. Solve by starting with one side (usually supply) through manual recruitment, seeding content, or offering the supply side a standalone value proposition. Concentrate on a narrow geography or vertical first. Reference strategies: Uber started with black cars, Airbnb started with events, and Yelp started with reviews before transactions.

B2B vs B2C Retention Dynamics

B2B retention depends on product becoming embedded in workflows, multi-user adoption within an organization, and integration with other tools. B2C retention depends on habit formation, content freshness, and emotional engagement. Do not apply B2C engagement tactics (daily push notifications, gamification) to B2B products. B2B retention is measured monthly or quarterly, not daily.

Referral Fraud Prevention

Common referral fraud patterns include self-referral with multiple accounts, referral rings between friends who churn after receiving rewards, and bot-generated fake referrals. Mitigate by requiring the referred user to complete a meaningful action (purchase, usage threshold) before rewards are distributed, implementing device fingerprinting, setting reasonable reward caps, and monitoring for anomalous patterns.

International Launch Sequencing

When launching internationally, do not launch everywhere simultaneously. Sequence by market attractiveness (TAM, competitive density, regulatory complexity), language/localization readiness, and existing demand signals. Start with one new market, prove the playbook, then expand. Payment methods, compliance requirements, and cultural norms vary significantly and can break launch plans built for the home market.

Related Skills

  • Paid Advertising -- Paid acquisition that PLG and viral loops can amplify or replace over time
  • CRO -- Activation and onboarding optimization overlaps heavily with CRO principles
  • Content Engine -- Content marketing that feeds growth loops and launch amplification
  • Analytics & Insights -- Cohort analysis, experiment measurement, and growth modeling
  • Influencer & Creator Marketing -- Creator partnerships for launch amplification and affiliate-influencer hybrids
  • Funnel Architect -- Growth engineering strategies plug into the broader acquisition and retention funnel

Supporting file: affiliate-marketing.md

Affiliate Marketing — Program Strategy

Affiliate marketing is a performance-based channel where external partners (affiliates) promote your product in exchange for commissions on qualified actions. When structured well, it delivers predictable, profitable customer acquisition.


Program Setup Guide

Platform Selection

Choose between building in-house or using an affiliate network/platform.

ApproachProsConsBest For
In-house (custom build)Full control, no platform fees, custom attributionEngineering investment, slower to launch, limited affiliate discoveryCompanies with dev resources and existing partner relationships
Affiliate SaaS platformFast launch, built-in tracking, affiliate management toolsMonthly fees, some customization limitsMost companies launching their first program
Affiliate networkAccess to large affiliate pool, built-in compliance, payment handlingHigher fees (network override), less control, commoditizedCompanies wanting rapid scale through established affiliates
HybridCombine in-house tracking with network distributionComplexity of managing multiple systemsMature programs optimizing for both control and reach

Program Setup Checklist

  • Define program goals (revenue target, number of active affiliates, target CAC)
  • Set commission structure and terms (see Commission Optimization section)
  • Select tracking platform or network
  • Implement conversion tracking (pixel, postback, API integration)
  • Create affiliate landing page explaining the program, benefits, and application process
  • Write program terms and conditions (legal review required)
  • Build creative asset library (banners, text links, email templates, product images)
  • Set up affiliate dashboard (reporting, link generation, payout tracking)
  • Configure fraud detection rules and monitoring
  • Design affiliate onboarding sequence (welcome email, getting started guide, first commission tips)
  • Establish payment terms and method (PayPal, wire, check; net-30 or net-60)
  • Create internal processes for affiliate approval, support, and escalation

Network Comparison

FeatureShareASaleImpactCJ AffiliateAwinPartnerStack
Best forSMB, e-commerceEnterprise, SaaSLarge brands, retailGlobal programsB2B SaaS
Setup cost$625 one-time + $35/moCustom pricingCustom pricing$5,000+ setupCustom pricing
Network fee20% of commissionsNegotiableNegotiableNegotiableNegotiable
Affiliate pool size270,000+100,000+170,000+240,000+65,000+
Tracking qualityGoodExcellentGoodGoodExcellent
SaaS featuresBasicAdvanced (partnerships)ModerateModerateAdvanced (PRM)
ReportingStandardAdvancedStandardStandardAdvanced
Global supportUS-focusedGlobalGlobalGlobal (EU strong)Global
Payment handlingIncludedIncludedIncludedIncludedIncluded
Cookie durationConfigurableConfigurableConfigurableConfigurableConfigurable
Integration easeEasy (Shopify, WP)ModerateModerateModerateEasy (SaaS stack)

Selection Criteria

Your SituationRecommended Platform
E-commerce, Shopify store, budget-consciousShareASale
Enterprise SaaS, complex partnership modelsImpact
Large brand, want established affiliate relationshipsCJ Affiliate
European or global audienceAwin
B2B SaaS, want partner relationship managementPartnerStack
Need full control and have engineering resourcesIn-house + Rewardful, FirstPromoter, or Tapfiliate

Commission Optimization

Commission Models

ModelHow It WorksTypical RateBest For
CPA (Cost Per Acquisition)Flat fee per converted customer$20-$200+ depending on ACVSaaS with predictable LTV, defined conversion event
Revenue share (recurring)Percentage of customer revenue, ongoing15-30% recurringSaaS with monthly subscriptions, long LTV
Revenue share (one-time)Percentage of first purchase only20-50% of first paymentE-commerce, one-time purchases
Tiered commissionRate increases with volumeBase rate + escalators at thresholdsMotivating top affiliates to increase volume
Hybrid (CPA + RevShare)Flat fee upfront + smaller ongoing percentage$50 CPA + 10% recurringBalancing affiliate motivation with program economics
Performance bonusesAdditional payouts for hitting milestonesVariesDriving behavior during specific campaigns or periods

Commission Rate Calibration

FactorLower CommissionHigher Commission
Customer LTVLow LTV (<$500)High LTV (>$2,000)
Conversion rateHigh (affiliates convert easily)Low (hard to convert, need incentive)
Competition for affiliatesFew competitors recruitingMany programs competing for same affiliates
Product awarenessWell-known brandUnknown brand needing introduction
Sales cycle lengthShort (same-session purchase)Long (multi-touch, weeks/months)

Tiered Commission Structure Example

TierMonthly ConversionsCommission RateBonus
Bronze1-1020%None
Silver11-2525%$100 monthly bonus
Gold26-5030%$300 monthly bonus + dedicated account manager
Platinum51+35%$500 monthly bonus + co-marketing budget + quarterly strategy call

Affiliate Recruitment Strategies

Affiliate Segments

SegmentDescriptionVolumeQualityRecruitment Approach
Content creators / BloggersWrite reviews, comparisons, tutorialsMediumHighOutreach based on existing content in your niche
YouTube / Video creatorsProduct reviews, tutorials, unboxingsMediumHighIdentify creators reviewing competitors
Email list ownersPromote via newslettersHighMediumLook for niche newsletters with engaged audiences
Coupon / Deal sitesList offers and discount codesVery HighLowSelectively recruit top-tier sites only
Comparison / Review sitesRank and compare productsMediumVery HighEnsure accurate listing, offer exclusive data
Social media influencersPromote on Instagram, TikTok, TwitterHighVariableSee Affiliate vs Influencer section
Niche community leadersPromote within forums, groups, communitiesLowVery HighBuild relationship first, offer program second
Existing customersHappy users who refer through affiliate linksLowHighestInvite top NPS respondents into affiliate program
Agencies / ConsultantsRecommend to their clientsLowVery HighPartner program with higher commissions

Recruitment Outreach Process

StepActionTimeline
1Identify target affiliates (search for niche content, competitor mentions)Ongoing
2Research each affiliate (audience size, content quality, engagement rate)Before outreach
3Personalize outreach (reference specific content, explain why your product fits)Individual emails
4Follow up if no response (2 follow-ups, 5-7 days apart)+5 and +12 days
5Onboard accepted affiliates (send welcome kit, schedule intro call for top-tier)Within 48 hours
6Provide first 30-day support (check in at Day 7 and Day 21, offer content ideas)First month
7Review performance and optimize (adjust commission, provide better assets)Monthly

Fraud Detection

Common Affiliate Fraud Types

Fraud TypeDescriptionDetection Method
Cookie stuffingAffiliate drops cookies without user knowledge to claim attributionMonitor conversion paths — flag conversions with no click event
Click fraud / Click spamGenerating fake clicks to inflate metrics or steal attributionAbnormal click-to-conversion ratios, geographic anomalies
Trademark biddingAffiliates bid on your brand terms in paid searchRegular SEM monitoring, brand + affiliate keyword alerts
Incentivized trafficOffering users cash/points to sign up through affiliate linkLow retention rates from affiliate cohort, high refund rates
Self-referralAffiliate signs up using their own linkCross-reference affiliate and customer data
Fake leads / form fillsSubmitting bogus information to trigger CPA payoutsLead quality scoring, email verification, phone verification
Return abusePurchase through affiliate link, then return after commission paidExtend commission hold period past return window

Fraud Prevention Checklist

  • Set commission hold period to 30-60 days (beyond refund window)
  • Monitor click-to-conversion ratios by affiliate (flag outliers)
  • Block trademark bidding in program terms, monitor with SEMrush or SpyFu
  • Require minimum customer retention period before commission is finalized
  • Review new affiliate applications manually (check website, traffic sources)
  • Implement IP analysis for click and conversion matching
  • Set maximum conversion rate threshold (flag if >20% without explanation)
  • Audit top 10 affiliates quarterly (traffic sources, content, compliance)
  • Use fraud detection tools built into your network/platform
  • Reserve contractual right to claw back commissions for fraudulent activity

Content Guidelines & Brand Protection

Affiliate Content Policy

AllowedRestrictedProhibited
Honest product reviewsIncome claims without disclosureFalse or misleading claims
Feature comparisonsDirect competitor disparagementTrademark misuse in domain names
Tutorial and how-to contentPricing guarantees (price may change)Spam (unsolicited email, comment spam)
Use of approved brand assetsModified logos or brand imageryCoupon codes not officially issued
FTC-compliant disclosureHidden affiliate relationshipsCookie stuffing or click fraud
Social media promotionImplied endorsement by companyTrademark PPC bidding (if restricted)

Brand Protection Checklist

  • Publish clear brand guidelines document for affiliates
  • Provide approved creative assets (logos, banners, product images)
  • Require FTC disclosure on all affiliate content ("This post contains affiliate links")
  • Monitor affiliate content quarterly for compliance
  • Set up Google Alerts for brand + affiliate-related queries
  • Include content compliance requirements in program T&Cs
  • Establish a violation escalation process (warning → commission hold → termination)
  • Maintain a list of approved and prohibited promotional methods

Program Management

Monthly Management Tasks

TaskFrequencyTime Investment
Review affiliate applicationsWeekly1-2 hours
Monitor top affiliate performanceWeekly1 hour
Process commission payoutsMonthly (net-30)1-2 hours
Audit for fraud and complianceMonthly2-3 hours
Refresh creative assets and offersMonthly2-4 hours
Affiliate newsletter / communicationBi-weekly or monthly1-2 hours
Recruit new affiliatesOngoing3-5 hours/week
Optimize commission structureQuarterly2-3 hours
Performance review and reportingMonthly2-3 hours

Key Program Metrics

MetricFormulaGoodGreat
Active affiliate rateAffiliates with 1+ conversion / Total affiliates10-20%20%+
Revenue per affiliateTotal affiliate revenue / Active affiliatesVariesTop 20% drive 80% of revenue
Affiliate CACTotal affiliate costs / Affiliate-driven customers<50% of paid CAC<30% of paid CAC
Affiliate contributionAffiliate revenue / Total revenue10-15%15-25%
Average commission rateTotal commissions / Total affiliate revenue15-25%Optimized per tier
Time to first conversionMedian days from affiliate activation to first sale<30 days<14 days
Affiliate retention rateAffiliates active this quarter / Active last quarter50-60%70%+

Affiliate vs Influencer Distinction

DimensionAffiliateInfluencer
CompensationPerformance-based (commission on sales/leads)Flat fee, product gifting, or hybrid (fee + commission)
Content styleReview, comparison, tutorial, deal-focusedLifestyle, narrative, brand integration
MeasurementTracked conversions, revenue, ROIImpressions, engagement, brand lift, tracked conversions
RelationshipTransactional, scalable, many affiliatesRelational, curated, fewer partnerships
Control over contentLow — affiliate creates independentlyModerate — briefs and approval process
TimelineOngoing, evergreenCampaign-based, time-bound
DiscoveryAffiliate networks, competitor analysisSocial platforms, influencer databases
Best forDriving measurable conversions at scaleBuilding brand awareness and trust with specific audiences
RiskBrand compliance, fraudOff-brand content, audience mismatch

When to Use Each

ScenarioUse AffiliateUse InfluencerUse Both
Driving direct sales, clear ROI neededYes
Building brand awareness in new marketYes
Product launch with sustained promotionYes
Scaling a proven acquisition channelYes
Reaching a specific niche audienceYes
Long-term evergreen content strategyYes
Seasonal campaign with urgencyYes
Mature program optimizing all channelsYes

Hybrid Model

Many programs blend affiliate and influencer approaches:

Influencer receives: Flat content creation fee ($500-$5,000) + affiliate commission (15-25%)
Brand receives: High-quality branded content + trackable, ongoing revenue from that content
Result: Influencer is motivated to create AND promote; brand gets awareness AND conversions

A well-run affiliate program is a portfolio of performance partnerships. Recruit deliberately, compensate fairly, monitor consistently, and treat your best affiliates like the revenue-generating partners they are.


Supporting file: experimentation-frameworks.md

Growth Experimentation — Frameworks & Methodology Reference

Experiment Prioritization Frameworks

ICE Score (Impact, Confidence, Ease)

DimensionScaleDefinition
Impact1-10How much will this move the target metric?
Confidence1-10How confident are you in the predicted impact? (based on data, research, or precedent)
Ease1-10How easy is this to implement? (time, resources, dependencies)
ICE Score = (Impact + Confidence + Ease) / 3

Example:
Experiment: Change CTA button color from gray to green
- Impact: 3 (minor UX change)
- Confidence: 4 (no strong data suggesting impact)
- Ease: 10 (5-minute code change)
- ICE Score: (3 + 4 + 10) / 3 = 5.7

Experiment: Redesign pricing page with social proof and FAQ
- Impact: 9 (pricing page is highest-intent page)
- Confidence: 7 (competitor analysis + user research supports it)
- Ease: 4 (requires design, copy, dev work)
- ICE Score: (9 + 7 + 4) / 3 = 6.7  ← Prioritize this one

Best for: Small teams, fast-moving startups, early-stage experimentation programs. Quick to score, easy to debate.

RICE Score (Reach, Impact, Confidence, Effort)

DimensionScaleDefinition
Reach# of users/monthHow many people will this affect in a given time period?
Impact0.25 / 0.5 / 1 / 2 / 3Minimal / Low / Medium / High / Massive impact per person
Confidence50% / 80% / 100%How certain are you? Low / Medium / High
EffortPerson-monthsTotal work required (design + dev + QA)
RICE Score = (Reach x Impact x Confidence) / Effort

Example:
Experiment: Add exit-intent popup with email capture on blog
- Reach: 50,000 visitors/month
- Impact: 1 (medium — captures some emails)
- Confidence: 80%
- Effort: 0.5 person-months
- RICE Score: (50,000 x 1 x 0.8) / 0.5 = 80,000

Experiment: Rebuild checkout flow to reduce steps from 5 to 3
- Reach: 8,000 checkout initiators/month
- Impact: 3 (massive — directly affects revenue)
- Confidence: 80%
- Effort: 3 person-months
- RICE Score: (8,000 x 3 x 0.8) / 3 = 6,400

Best for: Product teams with clear user data, growth teams needing to justify investment to stakeholders.

PIE Score (Potential, Importance, Ease)

DimensionScaleDefinition
Potential1-10How much room for improvement exists? (based on current performance vs benchmarks)
Importance1-10How valuable is the traffic/audience affected? (high-value pages score higher)
Ease1-10How easy is the test to implement?
PIE Score = (Potential + Importance + Ease) / 3

Best for: CRO teams focused on website optimization, where you're comparing pages/funnels against each other.

When to Use Each Framework

FrameworkBest ScenarioWeakness
ICEQuick prioritization, small teams, many ideasSubjective, no quantified reach
RICEData-rich environments, product teamsRequires user reach data, slower to calculate
PIECRO and website optimizationLimited to conversion optimization context

Hypothesis Format

Every experiment must start with a falsifiable hypothesis. A vague "let's try this" is not an experiment.

Standard Hypothesis Template

If we [specific change],
then [target metric] will [direction: increase/decrease]
by [estimated magnitude: %, absolute number, or range]
because [reasoning based on data, research, or user insight].

Examples of Strong Hypotheses

HypothesisStrength
"If we add customer testimonials to the pricing page, then the pricing-page-to-signup conversion rate will increase by 10-15% because user research shows that 68% of prospects cite 'lack of social proof' as their top hesitation."Specific metric, grounded in research, realistic magnitude
"If we reduce the signup form from 7 fields to 3 (email, name, password), then the form completion rate will increase by 25-40% because our analytics show a 60% drop-off between fields 3 and 7."Data-backed reasoning, clear change, measurable outcome
"If we send cart abandonment emails within 1 hour instead of 24 hours, then the cart recovery rate will increase by 15-20% because industry data shows email engagement drops 50% after the first hour."Industry benchmark as reasoning, testable timing change

Common Hypothesis Mistakes

MistakeExampleFix
No specific metric"Making the page better will improve performance"Define which metric and by how much
No reasoning"If we change the button to green, conversions will increase"Add the "because" — what evidence supports this?
Untestable"If we rebuild the entire product, users will be happier"Scope to a testable, isolated change
No magnitude"Conversion rate will increase"Estimate a range: "by 5-10%"
Multiple changes"If we change the headline, image, CTA, and layout..."Test one variable at a time, or use multivariate design

Experiment Types

TypeWhat It IsWhen to UseComplexity
A/B testTwo variants (control vs challenger) on the same page/elementTesting a single change with sufficient trafficLow
A/B/n testMultiple variants (3+) against a controlTesting several ideas for the same elementMedium
Multivariate (MVT)Multiple elements changed simultaneously, all combinations testedUnderstanding interaction effects between elementsHigh
Split URL testTraffic split between entirely different page URLsTesting fundamentally different page designsMedium
Feature flagNew feature exposed to a percentage of usersProduct changes, gradual rolloutsMedium
Holdout testSuppress a feature/campaign from a control groupMeasuring incremental impact of an existing featureLow-Medium
Sequential testRun variant A for a period, then variant BWhen traffic is too low for simultaneous splitLow (but less reliable)
Bandit (explore/exploit)Algorithm allocates traffic toward better-performing variant dynamicallyWhen you want to minimize opportunity cost during the testHigh

A/B Test Decision Criteria

Is your change a single, isolated variable?
├── Yes → A/B test
└── No → Multiple elements changing?
    ├── Yes, and I need to know interaction effects → Multivariate test
    ├── Yes, but they're part of a complete redesign → Split URL test
    └── No, it's a product feature → Feature flag with holdout

Statistical Foundations

Sample Size Calculation

Before running any test, calculate the required sample size to avoid inconclusive results.

InputDefinitionHow to Estimate
Baseline conversion rateCurrent conversion rate of the controlUse last 30-60 days of data
Minimum Detectable Effect (MDE)Smallest improvement worth detectingTypically 5-20% relative change
Statistical significanceProbability of avoiding false positivesStandard: 95% (alpha = 0.05)
Statistical powerProbability of detecting a true effectStandard: 80% (beta = 0.20)

Sample Size Reference Table (95% significance, 80% power)

Baseline CVR5% Relative MDE10% Relative MDE20% Relative MDE
1%3,070,000 per variant770,000 per variant193,000 per variant
2%1,500,000376,00094,500
5%580,000146,00036,700
10%275,00069,40017,500
20%125,00031,5008,000
50%38,0009,6002,500

Rule of thumb: If your baseline CVR is low or your desired MDE is small, you need very large sample sizes. If you can't reach the required sample size within 4-6 weeks, either increase your MDE threshold or find a higher-traffic test location.

Duration Estimation

Test Duration (days) = Required Sample Size per Variant x 2 / Daily Traffic to Page

Example:
- Baseline CVR: 5%
- MDE: 10% relative (5% → 5.5%)
- Required: 146,000 per variant = 292,000 total
- Daily traffic: 8,000 visitors/day
- Duration: 292,000 / 8,000 = 36.5 days → run for 5 weeks (include full weekday cycles)

Avoiding Statistical Pitfalls

PitfallWhat HappensHow to Avoid
Peeking at resultsChecking daily and stopping early when results look good inflates false positive rate to 20-30%Pre-commit to sample size and duration; only evaluate at the end
Underpowered testsTest ends with "no significant result" but sample was too small to detect real effectCalculate sample size before starting; do not run tests you cannot power
Multiple comparisonsTesting 10 variants without adjustment means ~40% chance of false positiveApply Bonferroni correction or use sequential testing methods
Novelty effectNew variant performs well initially because it is unfamiliar, then regressesRun tests for at least 2 full weeks; monitor for regression in week 2-3
Selection biasNon-random traffic split (e.g., different time periods or geographies)Use proper randomization; verify that control/treatment demographics match
Simpson's ParadoxOverall result is flat, but segments show opposite effects that cancel outAlways segment results by device, traffic source, new vs returning

Growth Experiment Categories (AARRR Framework)

Acquisition Experiments

ExperimentMetricExample
Channel testingCAC by new channelTest Reddit ads for B2B audience vs LinkedIn
Landing page variantsLanding page CVRTest long-form vs short-form landing page
Ad creative testingCTR, CPATest benefit-focused vs pain-focused ad copy
Referral mechanicsReferral conversion rateTest "Give $20, Get $20" vs "Give 1 month free, Get 1 month free"
SEO content formatOrganic traffic, time on pageTest comprehensive guide vs comparison post for same keyword
Partnership channelsQualified leads from partnersTest co-webinar vs guest blog vs integration marketplace listing
Outbound messagingReply rateTest personalized video vs text-only cold email

Activation Experiments

ExperimentMetricExample
Onboarding flowActivation rate (Day 7)Test guided setup wizard vs self-serve with tooltips
First-value accelerationTime-to-valueTest pre-populated templates vs empty state
Signup frictionSignup completion rateTest social login vs email-only signup
Welcome email sequenceDay 7 engagementTest 5-email sequence vs 3-email sequence
Personalized onboardingFeature adoption rateTest role-based onboarding paths vs generic
Empty state designFirst-action completionTest sample data vs "create your first [item]" prompt

Retention Experiments

ExperimentMetricExample
Engagement triggersWeekly active user rateTest push notification with insight vs generic reminder
Re-engagement campaignsReactivation rateTest incentive email vs product update email for dormant users
Feature stickinessFeature retention at Day 30Test in-app tip sequence vs video tutorial
Communication cadence30-day retentionTest weekly digest vs real-time notifications
Habit loop designSession frequencyTest streak mechanics vs progress bar
Community features90-day retentionTest forum access vs peer group matching

Revenue Experiments

ExperimentMetricExample
Pricing page designPricing-page-to-purchase CVRTest 3-tier vs 2-tier pricing layout
Upgrade triggersFree-to-paid conversionTest in-app usage limit popup vs email upgrade prompt
Upsell timingExpansion revenue per accountTest upgrade prompt at feature limit vs after 30 days
Annual vs monthly framingAnnual plan selection rateTest "Save 20%" vs "2 months free" messaging
Cross-sell placementAdd-on attach rateTest post-purchase page vs in-cart recommendation
Price anchoringAOVTest showing enterprise tier first vs starter tier first

Referral Experiments

ExperimentMetricExample
Incentive structureReferral send rateTest double-sided vs single-sided reward
Referral placementReferrals per userTest post-purchase prompt vs account settings page
Social sharingShare rateTest pre-written social post vs custom message
Referral messagingReferral conversion rateTest "Share and save" vs "Give your friend a gift"
Timing of referral askReferrals per activated userTest ask at activation vs ask after first value milestone

Experiment Tracking

Experiment Log Template

FieldDescriptionExample
Experiment IDUnique identifierEXP-2025-042
NameDescriptive experiment name"Pricing page social proof test"
OwnerPerson responsibleSarah Chen
HypothesisFull hypothesis statement"If we add 3 customer logos and review scores to the pricing page..."
Primary metricThe one metric this experiment targetsPricing page → signup conversion rate
Secondary metricsAdditional metrics to monitor for side effectsTime on pricing page, support ticket volume
Guardrail metricsMetrics that must NOT degradeOverall site conversion rate, revenue per visitor
Variant descriptionWhat the challenger variant changesAdd logo bar + 3 review scores above pricing table
Traffic allocation% of traffic to each variant50/50 control/variant
Required sample sizePre-calculated sample per variant35,000 per variant
Start dateWhen the experiment goes live2025-03-01
Planned end dateWhen sample size will be reached2025-03-28
Actual end dateWhen the experiment was actually stopped2025-03-30
ResultWon / Lost / InconclusiveWon
LiftMeasured change in primary metric+12.4% (95% CI: +6.1% to +18.7%)
Statistical significanceP-value or confidence levelp = 0.003 (99.7% confidence)
DecisionShip / Iterate / KillShip to 100%
Key learningWhat was learned regardless of outcomeSocial proof near pricing decisions significantly reduces hesitation

Experiment Status Board

StatusDefinitionColor
BacklogHypothesis written, not yet prioritizedGray
PrioritizedScored and scheduled for upcoming sprintBlue
In DevelopmentBeing built/designed/configuredYellow
RunningLive and collecting dataGreen
AnalysisData collection complete, being analyzedOrange
DecidedDecision made (ship/kill/iterate)Purple
ShippedWinning variant rolled out to 100%Dark Green

Experimentation Velocity

Benchmark Velocity Targets

Team SizeTarget Experiments/MonthNotes
Solo growth marketer2-4Focus on high-impact, easy-to-implement tests
Growth team (2-3)4-8Mix of quick wins and deeper experiments
Growth team (4-6)8-15Run parallel experiments across funnel stages
Dedicated experimentation team15-30Full experimentation infrastructure and culture

How to Increase Velocity

LeverImplementation
Reduce experiment scopeTest one variable, not redesigns; smaller scope = faster cycles
Pre-built test templatesStandardize experiment setup in your testing tool
Hypothesis backlogMaintain a scored backlog so tests are ready when a slot opens
Parallel testingRun experiments on different pages/funnels simultaneously (no overlap)
Automated analysisSet up auto-reporting when experiments reach significance
Learning documentationAvoid re-running failed experiments by documenting learnings
Reduce approval bottlenecksEmpower growth team to launch tests without executive approval

Learning from Failures

Why Experiments Fail (and What to Learn)

Failure TypeWhat HappenedWhat to Learn
Inconclusive (no winner)Neither variant significantly outperformedYour change was too small to matter, MDE was too tight, or the sample was too small
Negative result (variant lost)Challenger performed worse than controlThe hypothesis was wrong — but now you know. Document why and test a different approach
Execution failureTest was misconfigured, traffic not split properlyImprove QA process for experiment setup
External contaminationSeasonal effect, site outage, or marketing campaign skewed resultsRun tests for full weekly cycles; exclude known anomaly periods
Metric moved but business didn'tPrimary metric improved but revenue/retention didn't followYou optimized for the wrong metric — revisit metric selection

Post-Experiment Analysis Template

Experiment: [Name]
Result: [Won / Lost / Inconclusive]

1. What did we expect to happen?
   [Restate hypothesis]

2. What actually happened?
   [Primary metric result + confidence level + secondary metric results]

3. Why did it happen?
   [Analysis of user behavior, segment breakdowns, qualitative insights]

4. What did we learn?
   [Insight that applies beyond this single experiment]

5. What's the next experiment?
   [Follow-up test based on this learning, or new direction]

6. Should we update any existing assumptions or strategies?
   [Broader implications for growth model, personas, or messaging]

Growth Model: Inputs to Compound Growth

The Growth Equation

Growth = Acquisition x Activation x Retention x Revenue x Referral

Each factor is a multiplier. A 10% improvement in each:
1.1 x 1.1 x 1.1 x 1.1 x 1.1 = 1.61x total growth (61% improvement)

This is why experimentation compounds.

Growth Model Template

StageInput MetricCurrentTargetLeverExperiment Ideas
AcquisitionMonthly new signups2,0002,500New channels, referralsReddit ads test, referral program launch
Activation7-day activation rate35%45%Onboarding, first-valueGuided wizard, pre-built templates
Retention30-day retention60%70%Engagement, habit loopsWeekly insight email, streak feature
RevenueFree-to-paid conversion5%7%Pricing, upgrade promptsPricing page redesign, in-app limits
ReferralReferrals per activated user0.30.5Incentives, sharing mechanicsDouble-sided rewards, social sharing

Common Growth Experiments by Business Model

SaaS

StageHigh-Impact Experiment
AcquisitionFree tool or calculator that captures emails and demonstrates product value
ActivationRole-based onboarding flow that shows relevant features first
RetentionWeekly email with personalized usage insights and "try this feature" prompts
RevenueIn-app modal at usage limit showing upgrade value with social proof
Referral"Invite your team" prompt after activation milestone with free seat for referrer

eCommerce

StageHigh-Impact Experiment
AcquisitionQuiz/recommendation engine as top-of-funnel content play
ActivationFirst-purchase discount tied to email signup (10% off first order)
RetentionPost-purchase replenishment email timed to product consumption cycle
RevenueDynamic bundle recommendations on product pages ("Complete the look")
ReferralPost-purchase "give $15, get $15" referral card in shipping box

Marketplace

StageHigh-Impact Experiment
Acquisition (supply)Automated seller onboarding that imports listings from competitor platform
Acquisition (demand)SEO-optimized category pages targeting "[product] near me" queries
ActivationFirst transaction incentive for both buyer and seller (subsidized)
RetentionPersonalized weekly digest of new listings matching buyer's search history
RevenueTiered seller plans with premium placement and analytics
ReferralSeller referral program with reduced commission for referred sellers

Growth is not about one brilliant idea. It is about the velocity of learning. Every experiment, whether it wins or loses, makes the system smarter. The teams that grow fastest are not the ones with the best ideas. They are the ones that test the most ideas, learn the fastest, and compound those learnings over time.


Supporting file: launch-strategy.md

Launch Strategy — Product Launch Playbook

A disciplined launch process turns product releases into measurable growth events. This playbook covers the full lifecycle from planning through post-launch optimization.


Three-Tier Launch Framework

Not every release deserves the same investment. Categorize launches to allocate effort appropriately.

DimensionTier 1: Major LaunchTier 2: Feature LaunchTier 3: Minor Update
ScopeNew product, major rebrand, platform shiftSignificant new capability or moduleBug fixes, UI tweaks, incremental improvements
Lead time8-12 weeks4-6 weeks1-2 weeks
Cross-functional teamsProduct, Marketing, Sales, CS, PR, LeadershipProduct, Marketing, GrowthProduct, Marketing
External PRPress embargo, media outreach, analyst briefingBlog post, select media pitchesChangelog entry, in-app notification
Customer communicationEmail to full list, webinar, demo eventEmail to relevant segments, in-app announcementIn-app tooltip or banner
Sales enablementNew pitch deck, battle cards, training sessionsFeature one-pager, FAQ documentInternal Slack update
Content assetsLanding page, video, case study, blog seriesBlog post, help docs, short videoHelp doc update
Success metricsSign-ups, revenue impact, press coverage, NPSFeature adoption rate, engagement liftBug resolution rate, satisfaction score
ExamplesFigma launching FigJam, Notion launching AISlack launching HuddlesDashboard loading speed improvement

Product Hunt Launch Guide

Pre-Launch Preparation (2-4 Weeks Before)

TaskDetailsTimeline
Research top launches in your categoryStudy taglines, descriptions, and first comments of successful launches-4 weeks
Recruit a credible HunterFind someone with 1,000+ followers on Product Hunt; reach out personally-3 weeks
Build a supporter list200+ people who will upvote, comment, and share on launch day-3 weeks
Prepare assetsThumbnail (240x240), gallery images (5-8 screenshots), video (optional but recommended)-2 weeks
Write tagline and descriptionTagline: 60 chars max, clear and punchy. Description: problem → solution → proof-2 weeks
Draft first commentFounder story, why you built this, what makes it different. Personal and authentic.-1 week
Prepare launch day teamAssign roles: comment responder, social media, supporter coordinator-1 week

Launch Day Execution

  • Launch at 12:01 AM PST (Product Hunt resets daily)
  • Post founder's first comment immediately after listing goes live
  • Send first wave of notifications to supporter list (personal messages, not mass blast)
  • Share on Twitter/X with compelling hook and Product Hunt link
  • Post in relevant communities (Slack groups, Discord, Reddit — check rules first)
  • Respond to every comment within 30 minutes
  • Send second wave of notifications at 9 AM PST (US waking up)
  • Share progress updates on social media throughout the day
  • Send third wave at 12 PM PST if momentum is building
  • Thank supporters publicly in comments and social posts
  • Monitor and respond to questions until midnight PST

Post-Product Hunt

  • Send thank-you email to all supporters within 24 hours
  • Add "Featured on Product Hunt" badge to website (if applicable)
  • Create blog post summarizing the launch and results
  • Follow up with every lead generated from Product Hunt
  • Analyze traffic and conversion data from launch day

Waitlist Mechanics

Waitlist Strategy

ComponentStandard WaitlistViral WaitlistVIP Waitlist
Sign-upEmail onlyEmail + share to move upApplication with qualification criteria
Position visibilityHidden or shownShown with "move up" mechanicAcceptance/rejection notification
Incentive to shareNoneHigher position for referralsEarly access for qualified applicants
CommunicationPeriodic updatesReal-time position updatesPersonalized outreach
Best forSimple interest capturePre-launch buzz generationHigh-end or limited-capacity products
ToolsMailchimp, ConvertKitViral Loops, Waitlist.me, ReferralHeroTypeform + custom CRM workflow

Waitlist Email Sequence

EmailTimingContent
WelcomeImmediateConfirm position, explain what they're getting, set expectations
Social proofDay 3"X people joined after you" — create urgency
Behind the scenesDay 7Founder story, product preview, build connection
Referral nudgeDay 10"Move up the list by inviting friends" (for viral waitlists)
Sneak peekDay 14+Exclusive preview content, screenshots, or demo
Access grantedLaunch dayClear CTA, onboarding instructions, limited-time offer

Beta Program Design

Beta Types

Beta TypeAudienceDurationFeedback Method
Closed AlphaInternal team + advisors2-4 weeksDirect Slack/meetings
Private BetaHand-picked power users (50-200)4-8 weeksIn-app feedback widget, weekly surveys
Open BetaAnyone who signs up2-4 weeksCommunity forum, in-app feedback, analytics
DogfoodingEntire company uses product dailyOngoingInternal bug reports, feature requests

Beta Feedback Collection

  • In-app feedback button (always visible during beta)
  • Weekly NPS or CSAT micro-survey (1-2 questions)
  • Dedicated Slack or Discord channel for beta participants
  • Bi-weekly user interviews with 5-10 active beta users
  • Session recordings (with consent) via Hotjar, FullStory, or LogRocket
  • Automated bug reporting with screenshot capture
  • Feature request voting board (Canny, Productboard, or similar)
  • Exit survey for users who leave beta early

Pre-Launch Content Sequence

Build momentum in the weeks before launch with a structured content calendar.

WeekContent TypeChannelGoal
-6Problem-awareness blog postBlog, LinkedIn, TwitterEstablish the problem you solve
-5Industry data or original researchBlog, email listBuild authority and attract attention
-4Founder story / origin narrativeTwitter thread, LinkedIn postBuild personal connection
-3Teaser video or product previewSocial media, email listGenerate curiosity and anticipation
-2Early testimonials from beta usersSocial media, landing pageSocial proof before launch
-1"Launching next week" countdownEmail list, social mediaConvert awareness into intent
LaunchFull launch announcementAll channels simultaneouslyMaximum coordinated impact

Launch Day Checklist

Product Readiness (Complete Before Launch)

  • Core features tested and stable (zero P0/P1 bugs)
  • Onboarding flow tested with 5+ external users
  • Performance benchmarks met (page load <2s, API response <500ms)
  • Error monitoring configured (Sentry, Datadog, or equivalent)
  • Scalability tested for expected traffic (3-5x normal capacity)
  • Security review completed (auth, data handling, API keys)
  • Terms of service and privacy policy published
  • Payment processing tested end-to-end (if applicable)
  • Mobile/responsive experience verified
  • Accessibility basics covered (WCAG 2.2 AA minimum)

Marketing Assets Ready

  • Landing page live and optimized (hero, features, social proof, CTA)
  • Product demo video produced and uploaded
  • Press kit prepared (logos, screenshots, founder photos, fact sheet)
  • Blog post drafted and scheduled
  • Email announcement drafted for full list
  • Social media posts drafted for all platforms (Twitter, LinkedIn, Facebook, Instagram)
  • Community posts drafted (Reddit, Hacker News, Indie Hackers, relevant Slacks)
  • Help documentation and FAQ published
  • Pricing page live and tested

Team Coordination

  • All team members briefed on launch timeline and their roles
  • Support team trained on new features and common questions
  • Sales team equipped with updated pitch deck and battle cards
  • War room or dedicated Slack channel created for launch day communication
  • Escalation paths defined (who handles what if something breaks)
  • On-call engineering rotation confirmed for launch window

Distribution Execution

  • Email blast sent to subscriber list (timed for 10 AM recipient local time)
  • Social media posts published across all platforms
  • Product Hunt listing live (if applicable)
  • Press embargo lifted and pitches sent
  • Partner co-marketing posts coordinated
  • Paid ads activated (if budget allocated for launch amplification)
  • Influencer and advocate outreach completed
  • Community posts published (stagger across platforms to avoid spam flags)
  • Retargeting audiences updated with launch messaging
  • Internal all-hands or Slack announcement to celebrate and mobilize team

Monitoring and Response

  • Real-time analytics dashboard open (traffic, sign-ups, conversions)
  • Server health monitoring active
  • Social media monitoring active (brand mentions, hashtag tracking)
  • Support queue staffed at 2x normal capacity
  • Bug triage process active with fast-fix deployment capability
  • Hourly check-in cadence established for launch team

Post-Launch Optimization

First 7 Days

DayFocusActions
1Respond and stabilizeFix critical bugs, answer every comment and email, monitor server load
2Analyze first cohortReview Day 1 sign-up → activation funnel, identify drop-off points
3Iterate on onboardingFix top 3 friction points in sign-up/activation flow
4Amplify what worksDouble down on highest-performing channels and messages
5Engage early usersPersonal outreach to first 50-100 users, collect feedback
6Content follow-upPublish "What we learned from launch" post, share early metrics
7Week 1 retrospectiveFull team review of metrics, wins, failures, and priorities for Week 2-4

First 30 Days

WeekFocus AreaKey Actions
Week 1Stabilize and learnBug fixes, onboarding optimization, user interviews
Week 2Optimize conversionA/B test landing page, improve activation flow, refine messaging
Week 3Expand reachLaunch on additional channels, activate referral program, begin SEO
Week 4Retention focusAnalyze Day 7 and Day 14 retention, build engagement loops, plan next release

Launch Metric Tracking

Dashboard Metrics

MetricSourceTracking Frequency
Unique visitorsGoogle Analytics / PlausibleHourly on launch day, daily after
Sign-upsProduct databaseHourly on launch day, daily after
Activation rateProduct analytics (Mixpanel, Amplitude)Daily
Sign-up → Activation timeProduct analyticsDaily
Channel attributionUTM parameters, referral dataDaily
Revenue (if applicable)Stripe, payment processorDaily
Support ticketsHelp desk (Zendesk, Intercom)Hourly on launch day
NPS / CSATSurvey toolWeekly starting Day 7
Social mentionsBrand monitoring (Mention, Brandwatch)Hourly on launch day
Press coverageMedia monitoringDaily for first 2 weeks

Launch Scorecard Template

KPITargetActualStatus
Day 1 sign-ups______On track / Behind / Exceeded
Week 1 sign-ups______
Week 1 activation rate______
Month 1 sign-ups______
Month 1 activation rate______
Month 1 revenue______
CAC (by channel)______
Press articles______
Product Hunt ranking______
NPS at Day 30______

A great launch is not a single day. It is a coordinated sequence that builds momentum before, executes with precision during, and compounds results after. Plan the full arc.


Supporting file: product-led-growth.md

Product-Led Growth — Strategy & Frameworks

PLG is a go-to-market strategy where the product itself drives acquisition, expansion, and retention. Users experience value before committing budget.


PLG Flywheel

The PLG engine follows a four-stage flywheel. Each stage feeds the next.

Value Delivery → Habit Formation → Expansion → Advocacy
      ↑                                          |
      └──────────────────────────────────────────┘
StageObjectiveKey LeverExample
Value DeliveryGet user to "aha moment" fastFrictionless onboardingSlack — send first message in <2 min
Habit FormationEmbed product into daily workflowTriggers + variable rewardsNotion — daily workspace opens
ExpansionGrow revenue within accountsUsage-based pricing, seat expansionFigma — designer invites developer
AdvocacyTurn users into acquisition channelsReferral loops, social proofCalendly — every invite link = marketing

Freemium vs Free Trial Decision Tree

Use this framework to select the right model for your product.

FactorFavors FreemiumFavors Free Trial
Time-to-valueLong (user needs weeks to see ROI)Short (value apparent within days)
Marginal cost per userNear zeroMeaningful infrastructure cost
Network effectsStrong (more users = more value)Weak or absent
Product complexityLow — self-explanatory UIHigh — requires setup, training
Competitive landscapeCrowded — need to remove riskDifferentiated — value is clear
Virality potentialHigh (free users spread product)Low (usage is private/internal)
Average deal sizeLow ACV (<$5K/yr)High ACV (>$15K/yr)
Sales involvementMinimal — self-serve dominantRequired — consultative sale

Hybrid approach: Offer freemium for individuals and free trials for team/enterprise tiers. This captures both bottoms-up adoption and top-down evaluation.


Activation Metric Identification

Activation is the single most important PLG metric. It defines the moment a user first experiences meaningful value.

How to Find Your Activation Metric

  1. Pull behavioral data — Export event logs for the first 7-14 days of all users
  2. Segment by outcome — Split users into retained (active at Day 30+) vs churned
  3. Compare behaviors — Identify actions that retained users performed at significantly higher rates
  4. Rank by correlation — Find the action with the strongest correlation to retention
  5. Validate causation — Run an experiment: guide new users toward that action and measure retention lift
  6. Set the threshold — Define the minimum frequency or depth (e.g., "created 3 projects in first 7 days")

Activation Metric Examples

ProductActivation MetricThreshold
SlackMessages sent in a channel2,000 team messages
DropboxFile saved in Dropbox folder1 file in first session
HubSpotContacts imported + email sentWithin first 7 days
ZoomHosted a meeting with 2+ participantsFirst 48 hours
FigmaCreated and shared a design fileFirst 7 days

PQL (Product-Qualified Lead) Scoring Model

PQLs replace MQLs in PLG. A PQL is a user whose product behavior signals buying intent.

PQL Scoring Components

Signal CategoryWeightExamples
Activation completion25%Completed onboarding, hit aha moment
Usage depth25%Features used, frequency, session duration
Usage breadth15%Number of team members active, departments involved
Growth signals20%Seat additions, hitting plan limits, API usage
Firmographic fit15%Company size, industry, tech stack match

Scoring Tiers

TierScore RangeAction
Hot PQL80-100Sales outreach within 24 hours
Warm PQL60-79Automated nurture + contextual in-app upgrade prompts
Developing PQL40-59Product-led nurture sequences, feature discovery nudges
Early PQL0-39Onboarding optimization, activation campaigns

Self-Serve Onboarding Optimization

Onboarding Checklist

  • Time-to-first-value is under 5 minutes
  • Sign-up requires no more than 3 fields (email, name, password — or SSO)
  • Welcome flow asks 1-2 segmentation questions to personalize experience
  • Empty states include templates, sample data, or guided actions
  • Progress indicators show completion status
  • Tooltips and contextual help are triggered by user behavior, not timers
  • Email sequence supplements in-app guidance (Day 0, 1, 3, 7)
  • Users can invite teammates before completing onboarding
  • Mobile experience is functional even if desktop is primary
  • Exit points offer help (chat, docs, video) before abandonment

Onboarding Anti-Patterns

Anti-PatternWhy It HurtsFix
Feature tour on first loginOverwhelms user before they have contextDefer tours until relevant feature is needed
Mandatory profile completionAdds friction before value deliveryMake optional, ask progressively
No segmentationGeneric experience misses user needsAsk role/goal upfront, customize flow
Long email verification loopDelays activation by hours or daysAllow limited access immediately, verify later
Hiding the upgrade pathUsers can't self-serve to paidShow pricing contextually at limit moments

PLG Metrics Dashboard

Primary Metrics

MetricFormulaBenchmark (B2B SaaS)
Activation RateActivated users / Sign-ups20-40%
Time-to-Value (TTV)Median time from sign-up to activation<5 minutes (ideal), <24 hours (acceptable)
Free-to-Paid ConversionPaid users / Free users2-5% (freemium), 10-25% (free trial)
Expansion Revenue (% of ARR)Expansion MRR / Starting MRR>30% Net Revenue Retention
Viral Coefficient (K-factor)Avg invites per user x invite conversion rate>0.5 (good), >1.0 (viral)
Revenue Per User (RPU)Total revenue / Active usersVaries — track trend over time
Natural Rate of Growth (NRG)Annual growth rate from organic + PLG channels>50% = strong PLG motion

Cohort Tracking

Track these for each weekly or monthly sign-up cohort:

  • Day 1, Day 7, Day 30, Day 90 retention
  • Activation rate within first 7 days
  • Median time-to-activation
  • Free-to-paid conversion by Day 30, 60, 90
  • Expansion revenue generated by Day 180
  • Referrals generated per cohort

PLG for Different Business Models

Business ModelPLG ApproachKey ChallengeExample
Horizontal SaaSFreemium + viral sharingActivation across many use casesNotion, Airtable
Vertical SaaSFree trial + guided setupDomain-specific onboarding requiredGusto, Procore
API / Developer ToolsFree tier + usage-based pricingDocs and DX are the productStripe, Twilio
Marketplace / PlatformFree buyer side, monetize supplyCold start problemAirbnb, Upwork
InfrastructureFree tier with generous limitsExpansion triggers at scaleAWS, Vercel
Collaboration ToolsFree for small teams, paid at scaleMust reach team-level adoptionSlack, Figma

PLG + Sales-Assist Hybrid

Most successful PLG companies add sales as they scale. The model evolves:

Stage 1: Pure self-serve (0 → $1M ARR)
Stage 2: Self-serve + inbound sales for large accounts ($1M → $10M ARR)
Stage 3: PLG-qualified pipeline feeds AE team ($10M → $50M ARR)
Stage 4: Full hybrid — PLG for SMB, sales-led for enterprise ($50M+ ARR)

Implementation Priority

PriorityActionImpact
1Define and instrument activation metricFoundation for all PLG
2Reduce time-to-value to under 5 minutesDirectly lifts conversion
3Build PQL scoring and alertingConnects product usage to revenue
4Implement in-app upgrade prompts at limit momentsCaptures expansion intent
5Add viral loops (invites, sharing, embedding)Compounds growth over time
6Launch referral program for activated usersReduces CAC systematically

PLG compounds because every user is a potential acquisition channel, every team is an expansion opportunity, and every integration deepens retention. The product is the growth engine.


Supporting file: referral-systems.md

Referral Systems — Program Design & Optimization

A structured referral program turns satisfied customers into a scalable, low-CAC acquisition channel. The best programs align incentives for both referrer and referee.


Referral Program Templates

Template Comparison

ModelHow It WorksBest ForExample
Double-SidedBoth referrer and referee get rewardedSaaS, fintech, marketplacesDropbox — both get extra storage
Single-Sided (Referrer)Only the referrer is rewardedHigh-consideration purchasesAmex — referrer gets bonus points
Single-Sided (Referee)Only the new user gets a benefitLow-friction trials, e-commerce"Give your friend $20 off"
TieredRewards escalate with number of referralsCommunity-driven productsMorning Brew — unlock swag at milestones
MilestoneUnlock rewards at specific referral countsWaitlist and launch campaignsHarry's pre-launch — 5, 10, 25, 50 referral tiers
LeaderboardTop referrers win premium rewardsTime-bound campaigns, contestsLaunch competitions with grand prizes
Embedded / NativeReferral is built into the product UXCollaboration and network toolsCalendly — every link is a referral

Double-Sided Program Design

Referrer Action → Unique Link/Code Generated → Referee Signs Up →
Referee Qualifies (activation event) → Both Parties Rewarded
ComponentDecisionRecommendation
Referrer rewardCash, credit, free months, pointsMatch to what users already value in your product
Referee rewardDiscount, extended trial, bonusRemove friction for first purchase/activation
Qualification eventSign-up, activation, purchase, retentionTie to meaningful value moment, not just registration
Reward timingInstant vs delayedInstant for referrer motivation; delayed for fraud prevention
Cap per referrerUnlimited vs cappedCap at 10-20 initially; raise for power referrers

Incentive Design Principles

Reward Type Selection

Reward TypeProsConsBest For
Account creditHigh perceived value, keeps users in ecosystemNo value if user churnsSaaS, platforms
Cash / gift cardsUniversally appealing, easy to understandExpensive, attracts fraudFintech, high-ACV products
Free monthsLow marginal cost, extends retentionOnly valuable if user is payingSubscription products
Feature unlocksZero marginal cost, drives engagementLimited appeal if features aren't compellingFreemium products
Physical goods / swagTangible, shareable, social proofLogistics complexity, costBrand-driven companies
Charitable donationAligns with values, positive brandLower direct motivationMission-driven brands

Incentive Calibration Checklist

  • Reward value is 10-25% of customer LTV (ensures positive ROI)
  • Reward is immediately understandable (no complex calculations)
  • Reward matches user motivation (intrinsic vs extrinsic)
  • Double-sided rewards are roughly balanced (neither party feels shortchanged)
  • Escalating rewards exist for power referrers (5+ successful referrals)
  • Reward fulfillment is automated (no manual approval bottleneck)
  • Tax implications are documented for cash rewards above reporting thresholds
  • Reward expiration policy is clearly communicated

Referral Mechanics

Tracking Infrastructure

MechanismHow It WorksStrengthsWeaknesses
Unique referral linkURL with referrer ID parameterEasy to share, trackableCan be lost if user clears cookies
Referral codeAlphanumeric code entered at sign-upWorks offline, memorableRequires manual entry, friction
Email inviteDirect email sent from productHigh intent signal, personalizedLimited reach vs social sharing
In-app inviteShare directly within product UIContextual, low frictionRequires active product usage
QR codeScannable code linking to referral URLWorks for physical/event contextsNiche use case

Link Architecture

https://yourapp.com/invite?ref=USER_ID&campaign=CAMPAIGN_NAME

Parameters tracked:
- ref: unique referrer identifier
- campaign: which referral program variant
- channel: where the link was shared (email, social, direct)
- timestamp: when the link was generated

Attribution Rules

ScenarioRecommended Rule
Multiple referral links clickedLast-click attribution within 30-day window
Referral link + paid ad touchpointReferral takes priority (reward the advocate)
User signs up without link but enters codeCode attribution honored
Cookie expires before conversionNo attribution (extend cookie to 90 days)
Referred user already exists in systemNo reward (de-duplicate on email)

Fraud Prevention Tactics

Common Fraud Patterns

Fraud TypeDescriptionDetection Method
Self-referralUser creates multiple accounts to refer themselvesIP matching, device fingerprinting, email domain analysis
Referral ringsGroups of users refer each other in circlesNetwork graph analysis, timestamp clustering
Incentive abuseUsers sign up solely for the reward, then churnRequire activation event before reward; monitor 7-day retention
Bot-generated signupsAutomated account creation to claim rewardsCAPTCHA, behavioral analysis, signup velocity monitoring
Fake email accountsDisposable emails used for referee accountsBlock disposable email domains, require email verification

Fraud Prevention Checklist

  • Require a meaningful activation event before issuing rewards (not just sign-up)
  • Implement device fingerprinting to detect multi-accounting
  • Set velocity limits (max 5 referrals per day, 20 per week)
  • Block known disposable email domains
  • Hold rewards for 7-14 day cooling period before payout
  • Monitor referral-to-activation ratio by referrer (flag if <20%)
  • Review top referrers manually each month
  • Build an automated flagging system for anomalous patterns
  • Include anti-fraud terms in referral program T&Cs
  • Reserve the right to revoke rewards retroactively

Launch Playbook

Pre-Launch (2-4 Weeks Before)

WeekActionOwner
-4Define program goals, KPIs, and budgetGrowth / Marketing
-4Select referral platform or build in-house trackingEngineering
-3Design reward structure and fraud prevention rulesGrowth / Finance
-3Create referral landing page and email templatesDesign / Content
-2Build referral dashboard (referrer view + admin view)Engineering
-2Write program terms and conditionsLegal / Marketing
-1QA referral flow end-to-end (link generation → reward fulfillment)QA
-1Seed program with 50-100 power users for soft launchGrowth

Launch Day Checklist

  • Referral widget or page is live in product
  • Triggered email sent to top 20% most active users announcing program
  • In-app notification or banner promoting referral program
  • Social media announcement with shareable assets
  • Support team briefed on program details and FAQ
  • Analytics dashboards confirmed working (referrals, conversions, rewards)
  • Fraud monitoring active and alerting configured
  • Referral link generation tested across all platforms (web, mobile, email)

Post-Launch (First 30 Days)

DayAction
1-3Monitor conversion rates, fix broken flows, address support tickets
7First performance review — referral rate, share rate, conversion rate
14A/B test reward messaging and CTA placement
21Identify and engage top referrers with personalized outreach
30Full program review — ROI analysis, fraud audit, optimization plan

Benchmarks

Key Metrics

MetricFormulaGoodGreatElite
Referral RateReferrers / Total active users2-5%5-15%15%+
Share RateUsers who share link / Users who see referral prompt10-15%15-25%25%+
Invite Conversion RateReferred sign-ups / Total invites sent5-10%10-20%20%+
K-FactorInvites per user x conversion rate0.1-0.30.3-0.70.7+
CAC Reduction(Standard CAC - Referral CAC) / Standard CAC30-50%50-70%70%+
Referral LTV vs Organic LTVReferred user LTV / Organic user LTV1.0x1.1-1.25x1.25x+
Time to ReferralMedian days from sign-up to first referral30-60 days14-30 days<14 days

K-Factor Calculation

K = i × c

Where:
  i = average number of invites sent per user
  c = conversion rate of those invites

Example:
  Each user sends 5 invites, 10% convert → K = 5 × 0.10 = 0.5
  (Each user brings 0.5 new users — not viral, but contributes to growth)

Integration Points

Where to Surface Referrals in the Product

TouchpointTimingWhy It Works
Post-activation promptAfter user completes key actionUser just experienced value — peak motivation
Settings / Account pagePersistent, always accessiblePower users seek it out
Post-purchase confirmationAfter payment or upgradeBuyer's high — social proof motivation
Share / Export flowWhen user shares content externallyNatural sharing moment, embedded referral
Milestone celebrationsAfter achievement or usage milestoneEmotional high, gratitude response
NPS follow-upAfter user rates 9-10 on NPSPromoters are pre-qualified referrers
Billing / invoice pageDuring renewal or plan reviewBudget-conscious moment, credit appeals
Help / Support resolutionAfter successful support interactionGratitude and relief drive advocacy

Tech Stack Considerations

ApproachProsConsBest For
In-house buildFull control, deep integrationEngineering time, maintenance burdenProducts with unique referral mechanics
Referral SaaS (ReferralCandy, Friendbuy)Fast to launch, proven UXMonthly cost, limited customizationE-commerce, standard programs
Affiliate platform (Impact, PartnerStack)Scales to partners + affiliatesComplexity, costB2B SaaS with partner channels
CRM integration (HubSpot, Salesforce)Links referrals to sales pipelineRequires CRM maturitySales-assisted referral programs

The best referral programs don't feel like marketing programs. They feel like one friend helping another discover something valuable. Design for that.


Supporting file: retention-loops.md

Retention Loops — Engagement & Churn Prevention

Retention is the foundation of sustainable growth. No acquisition strategy survives a leaky bucket. This guide covers frameworks for building habit-forming products, predicting churn, and re-engaging lapsed users.


Hook Model Framework

Nir Eyal's Hook Model explains how products create habitual usage through a four-step loop.

Trigger → Action → Variable Reward → Investment
   ↑                                      |
   └──────────────────────────────────────┘

Step 1: Trigger

Triggers prompt the user to take action. They come in two forms.

Trigger TypeDescriptionExamples
External triggersEnvironmental cues that prompt actionPush notification, email, ad, CTA button, colleague mention
Internal triggersEmotional states or routines that prompt actionBoredom (scroll Instagram), anxiety (check Slack), curiosity (open Reddit)

Goal: Start with external triggers, then associate the product with internal triggers through repeated positive experiences.

Step 2: Action

The simplest behavior done in anticipation of a reward. Follows BJ Fogg's behavior model: B = MAT (Behavior = Motivation + Ability + Trigger).

Design PrincipleImplementation
Reduce frictionFewer clicks, faster load, simpler UI
Increase motivationClear value proposition at point of action
Ensure trigger visibilityNotification lands when user can act on it

Step 3: Variable Reward

The reward must be variable (unpredictable) to maintain engagement over time. Fixed rewards lose their power.

Reward TypeDescriptionProduct Example
Rewards of the TribeSocial validation, acceptance, belongingLikes, comments, follower counts
Rewards of the HuntResources, information, dealsNews feed content, search results, deal alerts
Rewards of the SelfMastery, competence, completionLeveling up, skill badges, streak counts

Step 4: Investment

The user puts something into the product that makes it more valuable over time and increases switching costs.

Investment TypeExampleRetention Effect
DataSaved preferences, history, filesMore personalization, harder to leave
ContentPosts, documents, projectsAccumulated value stored in product
ReputationReviews, ratings, follower countSocial capital that cannot transfer
SkillLearned workflows, keyboard shortcutsEfficiency advantage in current product
Social connectionsTeam members, contacts, followersNetwork locked into the platform

Churn Prediction Models

Leading Indicators of Churn

Identify users at risk before they cancel. These signals typically appear 2-4 weeks before churn.

Signal CategorySpecific IndicatorsRisk Level
Usage declineLogin frequency drops 40%+, session duration decreases, fewer core actionsHigh
Feature disengagementStops using advanced features, reverts to basic usage onlyMedium-High
Support signalsMultiple unresolved tickets, negative CSAT scores, complaint escalationHigh
Billing signalsFailed payment, downgrade inquiry, cancellation page visitCritical
Team signalsAdmin account goes inactive, seat count decreases, key user leavesHigh
Engagement signalsStops opening emails, ignores in-app messages, unsubscribes from updatesMedium
Competitive signalsVisits competitor pricing pages (if tracked), mentions competitors in supportMedium-High

Churn Risk Scoring Model

FactorWeightScore RangeScoring Method
Login frequency trend (14-day)25%0-100100 if stable/growing, 0 if >60% decline
Core feature usage (14-day)20%0-100Based on actions vs historical average
Support ticket sentiment15%0-100NLP sentiment analysis on recent tickets
Days since last login15%0-100100 if <3 days, 50 if 3-7, 25 if 7-14, 0 if >14
Contract/billing status10%0-100100 if healthy, 0 if payment failed or cancel page visited
Onboarding completion10%0-100Percentage of onboarding steps completed
NPS / CSAT score5%0-100Latest survey response normalized to 0-100

Risk Tiers:

  • 80-100: Healthy — nurture and upsell
  • 60-79: Monitor — proactive check-in
  • 40-59: At risk — intervention required
  • 0-39: Critical — immediate personal outreach

Win-Back Sequences

Email Win-Back Flow

EmailTiming After ChurnSubject Line ApproachContent Strategy
1Day 1"We're sorry to see you go"Ask for feedback, offer help resolving issues
2Day 7"Here's what you're missing"Highlight new features or improvements since they left
3Day 14"We've made changes based on your feedback"Show specific improvements relevant to their churn reason
4Day 30"Come back with [X% discount / free month]"Time-limited incentive to return
5Day 60"A lot has changed at [Product]"Major update roundup, no hard sell
6Day 90"Last chance: special offer for returning customers"Final incentive, then move to quarterly nurture

Win-Back Tactics by Churn Reason

Churn ReasonWin-Back ApproachOffer
Price / budgetDowngrade option, annual discount, pause subscription20-30% discount or free month
Missing featureNotify when feature ships, invite to betaEarly access to requested feature
Poor experiencePersonal apology from leadership, dedicated supportWhite-glove onboarding, dedicated CSM
Switched to competitorCompetitive comparison content, migration assistanceFree migration service, extended trial
No longer neededStay in touch with value content, seasonal re-engagementFree tier to maintain relationship
Bad onboardingOffer guided setup session, improved onboarding flow1-on-1 onboarding call with product expert

Cohort Analysis Methodology

Setting Up Cohort Analysis

Cohort Definition: Group users by sign-up week or month
Metric: Retention rate (% of cohort still active in period N)
Periods: Week 0, Week 1, Week 2, ... Week 12 (or Month 0-12)

Cohort Retention Table Template

CohortWeek 0Week 1Week 2Week 4Week 8Week 12
Jan W1 (500 users)100%45%32%22%18%15%
Jan W2 (600 users)100%48%35%25%20%17%
Jan W3 (550 users)100%52%38%28%23%20%

What to Look For

PatternInterpretationAction
Retention curve flattensUsers who survive early weeks tend to stickFocus on improving early retention (Week 1-2)
Recent cohorts retain betterProduct or onboarding improvements are workingContinue iterating on what changed
Recent cohorts retain worseSomething broke — regression, quality issue, wrong audienceInvestigate recent changes, review acquisition sources
Sharp drop at specific weekUsers hit a wall at that point in their journeyMap user journey to that week, identify friction
One segment retains much betterYou have found your ideal customer profileDouble down on acquiring that segment

Habit Loop Design

Daily Active Usage Checklist

Design your product to support daily habits.

  • There is a clear daily use case (not just a weekly/monthly tool)
  • Users receive a meaningful trigger each day (notification, email digest, dashboard)
  • The first action upon opening the product takes less than 5 seconds
  • Variable content or data refreshes daily (new insights, updated feeds, fresh tasks)
  • Completing the core action delivers immediate visible feedback
  • Users invest something with each session (data, content, preferences)
  • Streak or consistency tracking is visible (optional but powerful)
  • Social elements create accountability (team visibility, shared goals)

Habit Formation Timeline

PhaseDurationUser BehaviorProduct Role
LearningDays 1-7Exploring, evaluating, decidingHand-hold through activation, demonstrate value
PracticingDays 8-21Using with conscious effort, building routineReinforce triggers, celebrate progress
HabituationDays 22-60Usage becomes automatic, part of workflowReduce friction further, introduce advanced features
MasteryDays 60+Power user, advocate, investedExpansion opportunities, referral prompts, community

Re-Engagement Triggers

Trigger Types and Timing

TriggerChannelTimingContent
Inactivity nudgeEmail3 days without login"Your [project/task/data] is waiting for you"
Social triggerPush / EmailWhen a teammate takes action"Alex commented on your document"
Value triggerEmailWeeklyPersonalized digest of insights, metrics, or updates
Achievement triggerIn-app + EmailUpon milestone"You're 80% to your goal — keep going"
Content triggerEmailWhen new relevant content is published"New template in your category"
Feature triggerIn-app + EmailWhen relevant new feature ships"New: the feature you requested is live"
External triggerPushCalendar-based or event-based"Your report is ready for Monday's meeting"
FOMO triggerEmail / PushWhen peers are active"Your team completed 15 tasks this week"

Re-Engagement Priority Matrix

User SegmentDays InactivePriorityApproach
High-value, recently lapsed3-7 daysCriticalPersonal outreach, in-app message, email
High-value, moderately lapsed7-30 daysHighWin-back email sequence, phone call from CSM
Low-value, recently lapsed3-7 daysMediumAutomated nudge email, push notification
Low-value, moderately lapsed7-30 daysLowAutomated email sequence, no manual effort
Any segment, long-term lapsed30+ daysEvaluateCost-benefit analysis — may not be worth pursuing

Retention Benchmarks by Business Model

Monthly Retention (% active after N months)

Business ModelMonth 1Month 3Month 6Month 12Notes
B2B SaaS (SMB)70-80%55-65%45-55%35-45%Higher if annual contracts
B2B SaaS (Enterprise)90-95%85-92%80-88%75-85%Multi-year contracts stabilize
Consumer Subscription60-70%40-50%30-40%20-30%Highly variable by category
Mobile App (Social)25-35%12-18%8-12%5-8%Day 1 retention: 25-40%
Mobile App (Utility)30-40%18-25%12-18%8-12%Higher if daily use case exists
E-commerce (Repeat Purchase)25-35%15-22%10-15%8-12%Measured by repeat purchase
Marketplace30-40%20-30%15-22%10-18%Supply-side retains better than demand

Net Revenue Retention Benchmarks (B2B SaaS)

NRR RangeAssessmentExamples
>130%Elite — expansion significantly outpaces churnSnowflake, Twilio, Datadog
110-130%Strong — healthy expansion motionHubSpot, Slack, Zoom
100-110%Acceptable — expansion roughly offsets churnMost mature B2B SaaS
90-100%Concerning — slight net contractionChurn problem emerging
<90%Critical — revenue is shrinking from existing customersUrgent retention intervention needed

Customer Health Scoring

Health Score Components

ComponentWeightData SourceScoring
Product usage depth25%Product analyticsFeatures used / Total features available
Usage frequency20%Product analyticsActual logins / Expected logins for plan
Support health15%Help deskInverse of open tickets + sentiment
Relationship depth15%CRMNumber of stakeholders engaged, executive sponsor
Contract value trend10%Billing systemGrowing, stable, or declining
Onboarding progress10%Onboarding tracker% of implementation milestones completed
Survey sentiment5%NPS / CSAT toolLatest survey score

Health Score Actions

Health ScoreLabelColorAction
85-100ThrivingGreenUpsell/expand, request referral, case study candidate
70-84HealthyLight GreenStandard check-ins, feature adoption nudges
50-69NeutralYellowProactive outreach, usage review call, training offer
30-49At RiskOrangeEscalate to CSM, executive check-in, create success plan
0-29CriticalRedImmediate intervention, executive-to-executive call, save offer

Health Score Review Cadence

  • Automated alerts for any account dropping below 50 (immediate)
  • Weekly review of all accounts in Yellow or below by CS team
  • Monthly health score trend analysis across full customer base
  • Quarterly correlation analysis: health score vs actual churn outcomes (calibrate model)
  • Semi-annual model refinement based on prediction accuracy

Retention is not a feature. It is the cumulative result of delivering consistent value, building habits, and catching problems before users give up. Every percentage point of improved retention compounds into dramatically better unit economics.


Supporting file: viral-loops.md

Viral Loops — Design & Optimization

A viral loop is a self-reinforcing cycle where existing users bring in new users through normal product usage. When designed well, each cohort of users generates the next.


Viral Coefficient (K-Factor) Calculation

The K-factor measures how many new users each existing user generates.

K = i × c

Where:
  i = average number of invites (or exposures) sent per user
  c = conversion rate of those invites into new users

If K > 1.0 → Exponential (viral) growth
If K = 0.5-1.0 → Strong organic growth supplement
If K < 0.5 → Minimal viral contribution

K-Factor Examples

ProductInvites/User (i)Conversion Rate (c)K-FactorResult
Hotmail ("Get free email" signature)50+4%2.0+Explosive viral growth
Dropbox (storage referral)715%1.05Sustained viral growth
Slack (team invites)420%0.8Strong organic amplifier
Typical B2B SaaS25%0.1Marginal contribution

Improving K-Factor

LeverTacticImpact
Increase invites (i)Make sharing effortless, add multiple share channelsModerate
Increase invites (i)Embed invitations into core product actionsHigh
Increase conversion (c)Optimize landing page for referred visitorsHigh
Increase conversion (c)Offer incentive to referee (double-sided reward)Moderate
Increase conversion (c)Personalize invitation (include referrer name, context)Moderate

Viral Cycle Time

K-factor alone does not determine growth speed. Viral cycle time — the time it takes for one user to generate a new user — is equally critical.

Viral Cycle Time = Time from user sign-up → invite sent → invitee converts → invitee sends their own invite

Shorter cycle time = faster compounding, even with the same K-factor.
Cycle TimeK = 0.8 users after 20 daysK = 0.8 users after 40 days
1 day~11,000 from 1,000 seed~120,000
2 days~3,300~11,000
5 days~1,600~2,600
10 days~1,250~1,600

Tactics to Reduce Cycle Time

  • Trigger invite prompts during onboarding, not after (move invite step earlier)
  • Pre-compose invite messages (reduce effort to share)
  • Send invite reminders if initial invites have not converted within 48 hours
  • Offer instant rewards rather than delayed gratification
  • Reduce sign-up friction for invitees (SSO, pre-filled forms)
  • Enable real-time notifications when invitees take action

Loop Design Patterns

Pattern 1: Inherent Viral Loops

The product requires multiple users to function. Inviting others is not optional; it is the product.

CharacteristicDetail
DefinitionProduct value requires other users to participate
FrictionVery low — users must invite to use the product
ExampleZoom (need someone to meet with), Venmo (need someone to pay)
K-factor range0.5 - 2.0+
Optimization focusReduce sign-up friction for invitees, improve first-use experience

Pattern 2: Artificial Viral Loops

Incentives are added on top of the product to encourage sharing. The product works without sharing, but rewards make it appealing.

CharacteristicDetail
DefinitionUsers are incentivized to invite others through rewards
FrictionModerate — requires active decision to share
ExampleDropbox (free storage for referrals), Uber (ride credits)
K-factor range0.2 - 1.0
Optimization focusIncentive design, timing of referral prompt, reward fulfillment speed

Pattern 3: Word-of-Mouth Loops

Users share because the product is remarkable, not because they are prompted or incentivized.

CharacteristicDetail
DefinitionUsers voluntarily tell others about the product
FrictionHigh — requires strong emotional reaction to trigger sharing
ExampleChatGPT (novelty), Superhuman (status), Arc Browser (design)
K-factor range0.1 - 0.5 (harder to measure, but compounds over time)
Optimization focusDeliver exceptional experience, create shareable moments, build social proof

Pattern 4: Exposure / Embedded Loops

The product exposes itself to non-users as part of normal usage.

CharacteristicDetail
DefinitionNon-users encounter the brand through user-generated output
FrictionZero for the existing user — sharing happens automatically
ExampleCalendly link in emails, "Made with Squarespace" footer, Mailchimp badge
K-factor range0.3 - 1.5
Optimization focusVisibility of branding, CTA on exposed content, landing page conversion

Virality Assessment Framework

Score your product on each dimension (1-5) to assess viral potential.

DimensionScore 1 (Low)Score 5 (High)Your Score
Inherent multi-user needProduct is fully useful soloProduct requires multiple users___
Shareability of outputOutput is private/internalOutput is naturally shared externally___
Emotional triggerFunctional, no emotional chargeDelightful, surprising, status-granting___
Invite frictionComplex, multi-step invite processOne-click share/invite___
Invitee experienceConfusing landing, long sign-upInstant value, frictionless entry___
Network densityUsers' contacts are unlikely to need productUsers' contacts are ideal prospects___
Frequency of useMonthly or quarterlyDaily or multiple times per day___
VisibilityUsage is invisible to othersUsage is publicly observable___

Scoring:

  • 32-40: Strong viral potential — invest heavily in loop optimization
  • 24-31: Moderate potential — focus on 2-3 highest-scoring dimensions
  • 16-23: Supplemental virality — viral loops will assist but not drive growth
  • 8-15: Low viral potential — prioritize other acquisition channels

Social Proof Loops

Social proof creates a secondary viral effect by making adoption visible and desirable.

Social Proof TypeMechanismImplementation
Usage counters"Join 500,000+ teams using [Product]"Display on landing pages, in-app, and emails
Logo wallsRecognizable brand logos build trustFeature on home page, case study pages
Activity feedsShow real-time user actions"Sarah from Acme just signed up" (use ethically)
User-generated contentCustomers create content featuring productHashtag campaigns, template galleries
Reviews and ratingsThird-party validationG2, Capterra, App Store ratings
Milestone sharingUsers share achievements from the product"I completed 100 workouts with [App]" — auto-generated share cards

Content Virality Mechanics

When the product generates content, that content can become its own viral channel.

Content Viral Loop

User creates content → Content is shared/published → Viewer sees content →
Viewer notices product branding/CTA → Viewer signs up → New user creates content → ...

Optimization by Content Type

Content TypeViral LeverExample
Reports / DashboardsEmbed product branding, include "Create your own" CTATypeform results page
TemplatesMake templates publicly discoverable via SEOCanva templates, Notion templates
Interactive toolsOutput includes product attribution"Built with [Product]" watermark
User profiles / portfoliosPublic profiles rank in search, link back to productBehance, LinkedIn
Shared workspacesCollaborators must sign up to participateGoogle Docs, Miro boards

Network Effects vs Viral Loops

These are related but distinct concepts. Understanding the difference matters for strategy.

DimensionNetwork EffectsViral Loops
DefinitionProduct becomes more valuable as more users joinUsers bring in new users through sharing
Value driverUtility increases with network sizeGrowth increases with sharing behavior
ExampleTelephone network, Facebook, UberDropbox referral, Hotmail signature
Moat strengthVery strong — hard to leave a large networkModerate — can be copied by competitors
Cold start problemSevere — product has little value with few usersMild — product works solo, sharing is bonus
MeasurementActive users on platform, engagement per userK-factor, viral cycle time
Strategic focusReach critical mass in one segment firstOptimize each step of the invite flow

Combined power: The strongest growth engines combine both. Slack has network effects (more teammates = more value) and viral loops (team invites expose new organizations).


Optimizing Each Loop Step

Every viral loop has discrete steps. Optimize each one independently.

Step-by-Step Optimization

Loop StepMetricOptimization Tactics
1. User experiences valueActivation rateReduce time-to-value, improve onboarding
2. User encounters share triggerTrigger exposure ratePlace prompts at peak-value moments
3. User decides to shareShare rate (impressions → shares)Reduce friction, pre-compose message, add incentive
4. Invitee sees the invitationInvite delivery rateOptimize email deliverability, use multiple channels
5. Invitee clicks throughClick-through ratePersonalize message, clear value proposition
6. Invitee lands on productLanding page conversionTailored landing page for referred visitors
7. Invitee signs upSign-up completion rateMinimize fields, offer SSO, remove credit card requirement
8. New user activatesNew user activation rateDedicated onboarding for referred users
9. New user becomes referrerRepeat referral rateSurface referral prompt after activation

Funnel Benchmark Example

StepBenchmarkYour Product
Users who see share prompt80% of activated users___
Share prompt → share action15-25%___
Share → invitee click10-20%___
Click → sign-up20-40%___
Sign-up → activation20-40%___
Activated → refers others5-15%___

A/B Testing Priority for Viral Loops

PriorityWhat to TestExpected Impact
1Share prompt timing and placementHigh — determines if users even see the loop
2Invitation message copy and formatHigh — affects click-through from invitees
3Referred user landing pageHigh — conversion bottleneck for new users
4Incentive type and amountMedium — affects motivation to share
5Number of share channels offeredMedium — more channels = broader reach
6Sign-up flow for referred usersMedium — fewer steps = higher completion

Viral growth is not magic. It is engineering. Each step in the loop is a conversion rate that can be measured, tested, and improved. Small improvements compound across the entire loop.


Supporting file: skills/context-engine/platform-specs.md

Platform Specifications Reference

Last updated: 2026-02-11 This file is consumed by an AI agent to validate marketing content against platform requirements. All specs reflect current 2026 platform standards.


Section 1: Social Media Platform Specs

Instagram

Feed Posts

SpecValue
Character limit2,200
Optimal caption length125-150 characters (before "more" truncation)
Image formatsJPEG, PNG
Square image1080 x 1080 px (1:1)
Portrait image1080 x 1350 px (4:5)
Landscape image1080 x 566 px (1.91:1)
Max file size (image)30 MB
Hashtag limit30 max, 3-5 recommended
Algorithm priority signalsSaves, shares, comments, watch time, relationship closeness
Best posting timesTue-Thu 9-11 AM, Wed 11 AM, Fri 10-11 AM (local)

Instagram Reels

SpecValue
Duration15s, 30s, 60s, 90s (up to 3 min with some accounts)
Aspect ratio9:16 (vertical)
Resolution1080 x 1920 px
Video formatMP4, MOV
Max file size4 GB
Cover photo1080 x 1920 px
Caption limit2,200 characters
Hashtag limit30 max, 3-8 recommended
Algorithm priority signalsWatch-through rate, replays, shares, audio usage, originality
Best posting timesMon-Thu 9 AM, 12 PM, 7-8 PM (local)

Instagram Stories

SpecValue
Duration per slideUp to 60 seconds
Aspect ratio9:16
Resolution1080 x 1920 px
Image formatJPEG, PNG
Video formatMP4, MOV
Max file size (video)4 GB
Text-safe zoneKeep critical content within center 1080 x 1420 px (avoid top 250 px and bottom 250 px for UI overlays)
Sticker/link limit1 link sticker per story
Lifespan24 hours (unless added to Highlights)

Instagram Carousel

SpecValue
Slides2-20 per carousel
Aspect ratioAll slides must match; 1:1 or 4:5 recommended
Resolution (square)1080 x 1080 px
Resolution (portrait)1080 x 1350 px
Image formatJPEG, PNG
Video per slideUp to 60 seconds
Caption limit2,200 characters
Algorithm priority signalsSwipe-through rate, saves, shares, dwell time per slide

TikTok

SpecValue
Video duration15s, 60s, 3 min, 10 min, 30 min, 60 min
Aspect ratio9:16 (vertical)
Resolution1080 x 1920 px minimum
Video formatMP4, MOV, WebM
Max file size10 GB (desktop), 287 MB (mobile)
Caption limit4,000 characters
Hashtag limitNo hard limit; 3-5 relevant hashtags recommended
Photo modeUp to 35 images per carousel post
Algorithm priority signalsCompletion rate, rewatch rate, shares, comments, profile visits after viewing, content diversity score
Best posting timesTue 2-4 PM, Thu 12-3 PM, Fri 1-3 PM (local)
Text-safe zoneKeep text within center 720 x 1280 px area to avoid UI overlaps

LinkedIn

LinkedIn Post

SpecValue
Character limit3,000
Optimal length800-1,200 characters for engagement
Image dimensions1200 x 627 px (landscape), 1080 x 1080 px (square), 1080 x 1350 px (portrait)
Image formatJPEG, PNG, GIF
Max image file size8 MB
Video duration3 seconds to 10 minutes
Video formatMP4
Max video file size5 GB
Video aspect ratio1:1, 16:9, or 9:16
Document/carouselPDF upload, up to 300 pages, max 100 MB
Hashtag limitNo hard limit; 3-5 recommended
Algorithm priority signalsDwell time, comments (especially early), shares, relevance to network, content type diversity
Best posting timesTue-Thu 8-10 AM, Tue 10-11 AM peak (local business timezone)

LinkedIn Article

SpecValue
Headline limit100 characters
Body limit125,000 characters
Cover image1920 x 1080 px recommended
SupportsRich text, images, embeds, links
Algorithm priority signalsRead-through rate, comments, external shares

LinkedIn Newsletter

SpecValue
Title limit64 characters
Description limit250 characters
Logo image300 x 300 px
Cover image1920 x 1080 px
Body limitSame as Article (125,000 characters)
Frequency optionsDaily, weekly, biweekly, monthly
Algorithm priority signalsSubscriber growth rate, open rate, engagement rate

Twitter/X

SpecValue
Character limit (free)280
Character limit (Premium)25,000
Optimal tweet length71-100 characters for engagement
Image dimensions1600 x 900 px (16:9) recommended
Image formatsJPEG, PNG, GIF, WebP
Max images per tweet4
Max image file size5 MB (static), 15 MB (GIF)
Video duration0.5s to 140 seconds (up to 240 min for Premium)
Video resolution1920 x 1200 px max
Video formatMP4 (H.264 video, AAC audio)
Max video file size512 MB
Video aspect ratio16:9 or 1:1 recommended
Hashtag limitNo hard limit; 1-2 recommended
Algorithm priority signalsReplies, retweets, bookmark rate, link clicks, profile visits, verified status, dwell time
Best posting timesMon-Fri 8-10 AM, Wed 9-11 AM (local)

Facebook

Facebook Post

SpecValue
Character limit63,206
Optimal length40-80 characters for engagement
Image dimensions1200 x 630 px (landscape), 1080 x 1080 px (square)
Image formatJPEG, PNG, GIF, WebP
Max image file size30 MB
Link preview image1200 x 630 px minimum
Video duration1 second to 240 minutes
Video formatMP4, MOV
Video resolution1080p recommended
Max video file size10 GB
Algorithm priority signalsMeaningful interactions (comments, shares), watch time, content type matching user preference, Group engagement
Best posting timesMon-Fri 9 AM-12 PM, Wed 11 AM peak (local)

Facebook Reels

SpecValue
DurationUp to 90 seconds
Aspect ratio9:16
Resolution1080 x 1920 px
Video formatMP4, MOV
Max file size4 GB
Caption limit2,200 characters
Algorithm priority signalsOriginality, completion rate, shares, audio trends

Facebook Stories

SpecValue
Duration per slideUp to 20 seconds (video)
Aspect ratio9:16
Resolution1080 x 1920 px
Image formatJPEG, PNG
Video formatMP4, MOV
Max file size4 GB
Text-safe zoneCenter 1080 x 1420 px
Lifespan24 hours

Pinterest

Standard Pin

SpecValue
Title limit100 characters
Description limit500 characters
Image aspect ratio2:3 recommended (1000 x 1500 px)
Minimum image width600 px
Image formatJPEG, PNG, WebP
Max file size20 MB
Algorithm priority signalsSave rate, click-through rate, pin quality score, domain quality, keyword relevance, freshness
Best posting timesSat 8-11 PM, Fri-Sun for lifestyle; Tue-Thu for B2B (local)

Idea Pin

SpecValue
PagesUp to 20
Image resolution1080 x 1920 px (9:16)
Video duration per pageUp to 60 seconds
Video formatMP4, MOV
Title limit100 characters
Algorithm priority signalsView-through rate, saves, follows from pin, topic tag relevance

Video Pin

SpecValue
Duration4 seconds to 15 minutes
Aspect ratio1:1, 2:3, or 9:16
Resolution1080 px minimum width
Video formatMP4, MOV
Max file size2 GB
Title limit100 characters
Description limit500 characters

YouTube

YouTube Video

SpecValue
Title limit100 characters
Description limit5,000 characters
Tag limit500 characters total
Aspect ratio16:9 standard
Resolution1920 x 1080 px (1080p) minimum recommended; 3840 x 2160 (4K) supported
Video formatMP4 (H.264 + AAC) recommended; also MOV, AVI, WMV, FLV, WebM
Max file size256 GB
Max duration12 hours
Thumbnail1280 x 720 px (16:9), max 2 MB, JPEG/PNG/GIF
ChaptersMinimum 3 chapters, each 10+ seconds, first must start at 0:00
Algorithm priority signalsClick-through rate, watch time, average view duration, session time, engagement (likes, comments, shares), subscriber conversion
Best posting timesFri-Sat 9-11 AM, Thu 3-4 PM, weekday evenings 5-9 PM (viewer timezone)

YouTube Shorts

SpecValue
DurationUp to 3 minutes
Aspect ratio9:16 (vertical)
Resolution1080 x 1920 px
Title limit100 characters
Algorithm priority signalsSwipe-away rate (lower is better), replays, likes, subscriber conversion from Shorts

YouTube Live

SpecValue
ResolutionUp to 4K (2160p) at 60fps
Recommended bitrate (1080p)4,500-9,000 Kbps
Stream formatRTMP or HLS
Latency optionsUltra low, low, normal
Thumbnail1280 x 720 px
Schedule in advanceYes, up to weeks ahead

Reddit

SpecValue
Title limit300 characters
Text post limit40,000 characters
Image dimensionsNo strict requirement; 1200 x 628 px recommended for link posts
Image formatJPEG, PNG, GIF
Max images per post20 (gallery post)
Video durationUp to 15 minutes
Video formatMP4, MOV
Max video file size1 GB
Hashtag strategyNot used on Reddit; flair and subreddit selection matter instead
Algorithm priority signalsUpvote/downvote velocity, comment count, subreddit relevance, account karma and age
Best posting timesMon 6-8 AM, Wed-Fri 7-9 AM EST (US-centric subreddits)

Threads

SpecValue
Character limit500
Image dimensions1080 x 1350 px (4:5) recommended
Image formatJPEG, PNG
Max images per post10
Video durationUp to 5 minutes
Video formatMP4, MOV
Video aspect ratio9:16 or 1:1
Link previewSupported
Hashtag strategyTopic tags (1 per post)
Algorithm priority signalsReplies, reposts, engagement velocity, follower relationship
Best posting timesMon-Fri 8-10 AM, 12-1 PM (local)

Snapchat

SpecValue
Snap durationUp to 60 seconds (video), 10 seconds (image)
Aspect ratio9:16
Resolution1080 x 1920 px
Video formatMP4, MOV
Max file size5 MB (image), 32 MB (video for ads)
Spotlight videoUp to 3 minutes
Text limit (caption)80 characters on-screen
Text-safe zoneCenter 1080 x 1420 px
Algorithm priority signals (Spotlight)Completion rate, shares, favorites, screenshot rate
Best posting timesThu-Sat 10 PM-1 AM (local; younger demographic engagement peaks)

Section 2: Email Specifications

Subject Line Limits by Client

Email ClientVisible Characters (Desktop)Visible Characters (Mobile)
Gmail7040
Outlook (desktop app)7338
Outlook.com6038
Apple Mail7835
Yahoo Mail4635
Samsung MailN/A33

Recommendation: Keep subject lines under 40 characters for reliable cross-client mobile rendering. Front-load the most important words.

Preview Text (Preheader)

Email ClientPreview Text Visible Length
Gmail90-110 characters (varies by subject line length)
Outlook35-90 characters
Apple Mail75-100 characters
Yahoo Mail55-70 characters

Recommendation: Write 40-90 characters of preview text. If not explicitly set, clients pull the first visible body text. Use hidden preheader text in HTML to control this.

Email Body Specs

SpecValue
Recommended body width600 px (max 640 px)
Gmail clipping threshold102 KB (total HTML size including inline CSS). Messages exceeding this are truncated with a "[Message clipped] View entire message" link.
Max email size (practical)Keep under 100 KB HTML. Total with images should stay under 1 MB for fast loading.
Font stacksSystem fonts for reliability: Arial, Helvetica, Georgia, Times New Roman. Web fonts supported in Apple Mail, iOS Mail, Android (default), Outlook.com, Thunderbird. NOT supported in Gmail, Outlook desktop.
Minimum font size (mobile)14 px body, 22 px headlines (iOS auto-sizes text below 13 px)
Line height1.4-1.6 for body text
Background imagesSupported in most clients; NOT supported in Outlook desktop (use VML fallback)

Image Handling

SpecValue
Image formatsJPEG, PNG, GIF. WebP supported in Gmail, Apple Mail; NOT in Outlook.
Retina supportUse 2x resolution images displayed at 1x size (e.g., 1200 px image displayed at 600 px width)
Image blockingOutlook, some corporate clients block images by default. Always include alt text.
Animated GIFSupported everywhere except Outlook desktop (shows first frame only)
Max single image width600 px display width (1200 px actual for retina)
Image-to-text ratioAim for 60% text / 40% images to avoid spam filters

CTA Button Specs

SpecRecommendation
Minimum button size44 x 44 px (Apple HIG tap target)
Recommended button size48-60 px height, full-width on mobile
Button methodBulletproof buttons using HTML/CSS (padding-based). VML fallback for Outlook. Avoid image-only buttons.
Button text2-5 words, action-oriented. Max 30 characters.
Button contrastWCAG AA minimum (4.5:1 contrast ratio for text on button color)

Dark Mode Considerations

ClientDark Mode Behavior
Apple Mail / iOS MailFull color inversion with @media (prefers-color-scheme: dark) support
Gmail (Android)Partial: inverts light backgrounds to dark, adjusts text to white. Does NOT respect prefers-color-scheme.
Gmail (iOS)Partial: similar to Android. Does NOT respect prefers-color-scheme.
Outlook (desktop)Full inversion. Some transparent PNGs get white backgrounds.
Outlook.comPartial inversion. Supports [data-ogsc] and [data-ogsb] selectors.
Yahoo MailApplies its own dark theme. Limited CSS override support.

Dark mode design rules:

  • Add transparent padding around logos (prevents awkward color clashes)
  • Use semi-transparent PNGs with contrasting edges
  • Test with both dark and light backgrounds
  • Define both light and dark color schemes in CSS where supported
  • Avoid pure white (#FFFFFF) backgrounds; use #FAFAFA so dark mode detection triggers consistently

Mobile Rendering Rules

RuleDetail
Responsive approachUse fluid tables with max-width: 600px and width: 100%
Media queriesSupported in Apple Mail, iOS Mail, Android (default), Thunderbird. NOT supported in Gmail (any), Yahoo Mail, Outlook.
Stacking columnsUse display: block on table cells for mobile stacking via media queries, or use a hybrid/fluid approach for clients without media query support
Touch targetsMinimum 44 x 44 px for all tappable elements
Single-column layoutRecommended for mobile-first design

Apple Mail Privacy Protection (MPP)

ImpactDetail
Open trackingUnreliable. Apple pre-fetches all images (including tracking pixels) via proxy, inflating open rates. Approximately 50-60% of Apple Mail users have MPP enabled.
IP-based geolocationNo longer accurate for Apple Mail users. Apple proxies mask true IP.
Device detectionUnreliable. User-agent data is obscured.
Recommended responseShift KPIs to click-through rate, conversion rate, and revenue attribution. Use UTM parameters for tracking. Build engagement segments based on clicks, not opens.

Section 3: Ad Platform Creative Specs

Google Ads

Responsive Search Ads (RSA)

SpecValue
HeadlinesUp to 15; each max 30 characters
DescriptionsUp to 4; each max 90 characters
Display URL path2 fields, each max 15 characters
Final URLRequired
PinningAvailable for headlines (positions 1, 2, 3) and descriptions (positions 1, 2)
Minimum required3 headlines, 2 descriptions
RecommendationProvide all 15 headlines and 4 descriptions for maximum combinations

Google Display Ads

SpecValue
Landscape image1200 x 628 px (1.91:1) — required
Square image1200 x 1200 px (1:1) — required
Portrait image960 x 1200 px (4:5) — optional
Logo (landscape)1200 x 300 px (4:1) — optional
Logo (square)1200 x 1200 px (1:1) — required
Image file sizeMax 5.12 MB each
Image formatJPEG, PNG
Short headlineMax 30 characters (up to 5)
Long headlineMax 90 characters (1)
DescriptionMax 90 characters (up to 5)
Business nameMax 25 characters
CTA optionsAutomated, Learn More, Get Quote, Apply Now, Sign Up, Contact Us, Download, Book Now, Shop Now, Visit Site

Performance Max (PMax)

SpecValue
ImagesUp to 20. Landscape (1200x628), square (1200x1200), portrait (960x1200). Min 1 landscape and 1 square required.
LogosUp to 5. Square (1200x1200) required. Landscape (1200x300) recommended.
VideosUp to 5. Landscape (16:9), square (1:1), vertical (9:16). Min 10 seconds. If none provided, Google auto-generates from assets.
HeadlinesUp to 5, max 30 characters each
Long headlinesUp to 5, max 90 characters each
DescriptionsUp to 5, max 90 characters each. Plus 1 short description max 60 characters.
Business nameMax 25 characters
CTAAutomated or manual selection from standard options
Audience signalsRequired: custom segments, interests, demographics, remarketing lists

YouTube Ads

FormatSpec
Skippable in-streamMin 12 seconds, no max. Skippable after 5s. Recommended 15-30s for performance.
Non-skippable in-stream15 seconds exactly (20s in some regions)
Bumper adMax 6 seconds, non-skippable
In-feed (Discovery)Thumbnail 1280x720 (auto-selected or custom). Title max 100 chars. Description max 2 lines.
Video resolution1920x1080 (16:9) or 1080x1920 (9:16) for Shorts ads
File formatMP4 recommended
Max file size256 GB (same as standard YouTube upload)
Companion banner300 x 60 px (desktop, auto-generated or custom)

Google Shopping

SpecValue
Product titleMax 150 characters (first 70 most visible)
Product descriptionMax 5,000 characters
Product imageMin 100 x 100 px (non-apparel), 250 x 250 px (apparel). Recommended 800 x 800+. Max 64 MP.
Image formatJPEG, PNG, GIF (non-animated), BMP, TIFF
Image backgroundWhite or transparent recommended
Image contentNo watermarks, logos, promotional text, borders

Meta Ads (Facebook & Instagram)

Feed Ads

SpecValue
Primary text125 characters recommended (max 2,200 before truncation)
Headline27 characters recommended (max 255)
Description27 characters recommended (max 2,200)
Image (single)1080 x 1080 px (1:1) or 1200 x 628 px (1.91:1)
Image formatJPEG, PNG
Max image file size30 MB
Video aspect ratio1:1 or 4:5 (feed), 9:16 (Stories/Reels)
Video duration1 second to 241 minutes
Video formatMP4, MOV
Max video file size4 GB
Video resolution1080 x 1080 px minimum
CTA optionsShop Now, Learn More, Sign Up, Download, Get Offer, Book Now, Contact Us, Apply Now, Subscribe, Get Quote, Watch More, Send Message, Get Directions

Stories & Reels Ads

SpecValue
Aspect ratio9:16
Resolution1080 x 1920 px
Stories video duration1-120 seconds
Reels video duration1-90 seconds
Text-safe zoneKeep text/logos within center 1080 x 1420 px
Primary text125 characters
Headline40 characters

Carousel Ads

SpecValue
Cards2-10
Image per card1080 x 1080 px (1:1)
Video per cardUp to 240 minutes; 1:1 aspect ratio
Headline per card32 characters recommended
Description per card18 characters recommended
Primary text125 characters recommended
Landing URLUnique per card or single destination

Collection Ads

SpecValue
Cover image/video1200 x 628 px or 1080 x 1080 px
Product imagesPulled from catalog (min 4 products)
Headline40 characters
Opens intoInstant Experience (full-screen mobile)

LinkedIn Ads

Sponsored Content (Single Image)

SpecValue
Introductory text600 characters max (150 recommended)
Headline200 characters max (70 recommended)
Description300 characters max (100 recommended)
Image1200 x 627 px (1.91:1) recommended. Also supports 1080 x 1080 (1:1) and 1080 x 1350 (4:5).
Image file sizeMax 5 MB
Image formatJPEG, PNG, GIF
CTA optionsApply, Download, View Quote, Learn More, Sign Up, Subscribe, Register, Join, Attend, Request Demo

Sponsored Content (Video)

SpecValue
Duration3 seconds to 30 minutes
Aspect ratio16:9 (landscape), 1:1 (square), 9:16 (vertical)
Resolution360p to 1080p
File formatMP4
Max file size200 MB
CaptionsSRT file upload supported and recommended

Sponsored Messaging (Message Ads)

SpecValue
Subject lineMax 60 characters
Message bodyMax 1,500 characters
CTA button textMax 20 characters
Banner image300 x 250 px
Clickable links in bodyUp to 3

Document Ads

SpecValue
File formatPDF, DOC, DOCX, PPT, PPTX
Max file size100 MB
Max pages300 (first 5 shown as preview in feed)
Introductory text600 characters max
Headline200 characters max
Lead gen formOptional gating after preview pages

TikTok Ads

In-Feed Ads

SpecValue
Aspect ratio9:16, 1:1, or 16:9
Resolution720 x 1280 px minimum (9:16 recommended)
Video duration5-60 seconds (9-15 seconds recommended)
Video formatMP4, MOV, MPEG, AVI
Max file size500 MB
Ad description1-100 characters (emoji allowed)
Display nameMax 40 characters
CTA optionsDownload, Learn More, Shop Now, Sign Up, Contact Us, Apply Now, Book Now, Get Quote, Subscribe, Order Now, View Now

TopView Ads

SpecValue
Duration5-60 seconds
Resolution1080 x 1920 px
Aspect ratio9:16
PlacementFirst in-feed ad seen when opening the app
File formatMP4, MOV
Max file size500 MB
SoundRequired (auto-play with sound on)

Spark Ads

SpecValue
SourceBoost existing organic TikTok posts (own or authorized third-party)
SpecsSame as original post (no modification to video)
Added featuresCTA button, landing page URL, tracking pixel
AuthorizationRequires video authorization code from creator
DurationCampaign-controlled

Pinterest Ads

SpecValue
Standard Pin ad image1000 x 1500 px (2:3)
Square Pin ad image1000 x 1000 px (1:1)
Max aspect ratio1:2.6
Image formatJPEG, PNG
Image file sizeMax 20 MB
TitleMax 100 characters
DescriptionMax 500 characters
Video Pin ad duration4 seconds to 15 minutes
Video resolution1080 px width minimum
Video formatMP4, MOV
Video max file size2 GB
Idea Pin adUp to 20 pages, 1080 x 1920 px per page
Shopping adLinked to product catalog; standard Pin specs
CTA optionsAutomated based on campaign objective

Amazon Ads

Sponsored Products

SpecValue
TypeKeyword- or product-targeted; uses existing product listing
ImageProduct listing main image (auto-pulled from catalog)
HeadlineNot customizable (uses product title)
No custom creativeAd uses existing product detail page content

Sponsored Brands

SpecValue
HeadlineMax 50 characters
Logo400 x 400 px minimum, PNG/JPEG, max 1 MB
Custom image1200 x 628 px recommended
Products featured3+ ASINs
Video (Sponsored Brands Video)6-45 seconds; 1920 x 1080 (16:9) or 1080 x 1920 (9:16) or 1080 x 1080 (1:1); MP4/MOV; max 500 MB
Store SpotlightLinks to brand Store pages

Sponsored Display

SpecValue
Custom image1200 x 628 px (landscape), 1200 x 1200 px (square)
Logo600 x 600 px minimum
HeadlineMax 50 characters
Image formatJPEG, PNG
Max file size5 MB
Video6-30 seconds, MP4, 1280 x 720 min, max 500 MB
TargetingProduct, audience (views, purchases), contextual

Section 4: Schema Markup Reference

Use schema.org structured data (JSON-LD format recommended) to enhance search appearance and enable rich results.

Schema TypeWhen to UseRich Result
ArticleBlog posts, news articles, editorial content. Use NewsArticle for timely news, BlogPosting for blogs.Article carousel, headline in Top Stories
FAQPagePages with a list of questions and answers. Must show Q&A on the visible page (not just in markup).Expandable FAQ dropdowns in SERP
HowToStep-by-step instructional content (recipes, DIY, tutorials). Each step must be a distinct action.Step-by-step rich result with images/video
ProductProduct pages. Include name, image, description, offers (price, availability, currency).Product snippet with price, availability, rating
LocalBusinessBusinesses with a physical location. Include address, phone, hours, geo coordinates. Subtype to specific business type (e.g., Restaurant, Dentist).Knowledge panel, Maps integration
OrganizationCompany/brand homepage. Include name, logo, URL, social profiles, contact info.Knowledge panel, logo in search
PersonAuthor pages, speaker bios, team pages. Link to social profiles and authored content.Knowledge panel for notable people
Review / AggregateRatingProduct reviews, service reviews. AggregateRating for summary of multiple reviews. Must represent genuine user reviews.Star ratings in SERP
EventUpcoming events with date, location, ticket info. Include startDate, location, offers for tickets.Event listing with date, venue, ticket link
VideoObjectVideo content on pages. Include name, description, thumbnailUrl, uploadDate, duration, contentUrl or embedUrl.Video carousel, key moments
SpeakableContent optimized for text-to-speech / voice assistants. Identify which sections are most suitable for audio playback.Voice assistant eligibility (Google Assistant)
BreadcrumbListAll pages with breadcrumb navigation. Reflects the page hierarchy.Breadcrumb trail in SERP instead of raw URL
SiteNavigationElementMain site navigation menus. Helps search engines understand site structure.Sitelinks refinement (indirect)

Schema Implementation Notes

  • Format: Always use JSON-LD (recommended by Google) over Microdata or RDFa.
  • Placement: Insert <script type="application/ld+json"> in the <head> or <body> of the page.
  • Validation: Test with Google Rich Results Test (https://search.google.com/test/rich-results) and Schema Markup Validator (https://validator.schema.org).
  • Nesting: Nest related schemas (e.g., Product containing AggregateRating and Offers).
  • Avoid: Do not mark up content that is not visible on the page. Do not use schema for deceptive purposes. Google may issue manual actions for misleading structured data.

Section 5: Image Format Guide

Format Comparison

PropertyWebPAVIFPNGJPEG
Compression typeLossy + LosslessLossy + LosslessLosslessLossy
TransparencyYesYesYesNo
AnimationYesYes (limited tooling)Yes (APNG)No
Typical file size vs JPEG25-35% smaller40-50% smaller5-10x largerBaseline
Encoding speedFastSlow (CPU-intensive)FastFast
Decoding speedFastModerateFastFast
Color depth8-bit8, 10, 12-bit (HDR support)8, 16-bit8-bit
Max dimensions16,383 x 16,383 pxNo practical limitNo practical limit65,535 x 65,535 px
Progressive loadingNoYesNo (interlaced PNG exists)Yes

Browser Support (as of 2026)

FormatChromeFirefoxSafariEdgeiOS SafariAndroid
WebP32+65+16+18+16+4.2+
AVIF85+93+16.4+85+16.4+85+
PNGAllAllAllAllAllAll
JPEGAllAllAllAllAllAll

When to Use Each Format

FormatBest ForAvoid When
WebPGeneral web images. Default choice for photos, illustrations, thumbnails. Best balance of compression, quality, and compatibility.Email campaigns (limited client support), environments requiring lossless at maximum quality.
AVIFHero images, high-quality photography where file size is critical. Best compression ratio available. Use when encoding time is not a constraint.Bulk image processing pipelines (slow encoding), older browser support required without fallback, email.
PNGLogos, icons, screenshots, images with text, transparency over complex backgrounds, any image requiring pixel-perfect lossless quality.Photographs (file size too large), any large image where lossy compression is acceptable.
JPEGUniversal fallback. Email images. Social media uploads (platforms re-encode anyway). Legacy system compatibility.Images with text (compression artifacts), transparency needed, logos or sharp-edged graphics.

Implementation Best Practice

Use the <picture> element with format fallback:

<picture>
  <source srcset="image.avif" type="image/avif">
  <source srcset="image.webp" type="image/webp">
  <img src="image.jpg" alt="Description" width="800" height="600" loading="lazy">
</picture>

Key rules:

  • Always include width and height attributes to prevent Cumulative Layout Shift (CLS)
  • Use loading="lazy" for below-the-fold images
  • Use loading="eager" or fetchpriority="high" for LCP (Largest Contentful Paint) images
  • Serve responsive sizes with srcset and sizes attributes for resolution switching
  • Compress JPEG at quality 75-85 for web, WebP at quality 75-80, AVIF at quality 60-70
  • Always strip EXIF metadata for web delivery (privacy and file size)

How do I install Growth engineering in Cursor, Claude Code, or Codex?

Run npx skills add indranilbanerjee/digital-marketing-pro --skill growth-engineering in the project where you want it, then ask your agent for the skill by name. The --skill flag installs only Growth engineering, not every skill in the repository.

Where does Growth engineering come from and what license is it under?

Growth engineering comes from the indranilbanerjee/digital-marketing-pro repository on GitHub. That repository has 190 GitHub stars. The skill is published under the MIT license.

Prefer plain text? Read the Growth engineering guide as markdown.