Clew

How to add a paywall upgrade prompt in a v0 app without a developer

A soft paywall in a v0 app: when a free user reaches a paid feature, a modal explains the upgrade and links to your pricing page — targeted by plan, measured, and editable without a release.

Time
● 20 minutes
Price
14-day free trial, no card
Who does it
You and the v0 chat

Example: an upgrade prompt in a v0 app

A v0 analytics app offers CSV export on paid plans. Free users clicking data-tour="export-csv" on /dashboard/reports see “CSV export is on Team — try it free for 14 days” linking to the app’s pricing page.

What Clew does and doesn’t do. Clew shows the upgrade prompt — a modal with your text and a link to your own pricing or checkout page — to the users your rules select. It doesn’t take payments, doesn’t manage subscriptions and doesn’t hide or lock content: your app decides who has access, your billing provider charges the card.

This format is part of the Pro plan. Every new account starts with a 14-day free trial with all formats and audience rules, no card required. When the trial ends nothing is deleted and published items keep showing; the Free plan keeps tours and tooltips free.

How to add the paywall prompt in a v0 app, step by step

  1. Step 01

    Copy your Clew snippet

    Create a free account (or sign in), add your site and open Admin → Overview. Click the line in the “No signal from the widget yet.” card to copy it — it carries your real site key instead of the placeholder.

    <!-- Clew: replace PASTE_YOUR_SITE_KEY with the site key from Admin > Overview -->
    <script src="https://tryclew.io/widget/PASTE_YOUR_SITE_KEY.js" async></script>
    Clew admin Overview with the embed line and a masked site key (paywall upgrade prompt in a v0 app)
    Step 1 · schematic illustration
  2. Step 02

    Open the chat of your v0 project

    Open the project in v0. v0 generates Next.js with the App Router, so the right file is app/layout.tsx.

    An app builder with the AI chat panel next to the preview (paywall upgrade prompt in a v0 app)
    Step 2 · schematic illustration
  3. Step 03

    Send the prompt with your key

    Replace PASTE_YOUR_SITE_KEY with your key and send the prompt. It uses next/script, which is how Next.js loads third-party scripts.

    Add the Clew onboarding widget to this app.
    
    Insert this exact tag once so it loads on every page, including after client-side route changes:
    <script src="https://tryclew.io/widget/PASTE_YOUR_SITE_KEY.js" async></script>
    
    This is a v0 project on Next.js App Router: in app/layout.tsx import Script from "next/script" and add <Script src="(the same URL)" strategy="afterInteractive" /> inside <body>.
    
    After the signed-in user is loaded, and whenever the subscription changes, call Clew.identify({ plan: <the user's current plan id as a string, e.g. "free"> }). If the widget may not have loaded yet, first define the queue stub: window.TutorKit = window.TutorKit || { q: [], identify: function (p) { this.q.push(["identify", p]); } }; then call window.TutorKit.identify(...). Add a data-tour attribute to the buttons of paid features (for example data-tour="export"). Do not add any payment, gating or paywall logic of your own and do not change what the buttons do.
    
    Rules:
    - Use the script URL exactly as given. Do not download it, bundle it or install an npm package.
    - If the project sets a Content-Security-Policy, allow https://tryclew.io in script-src and connect-src.
    - Change nothing else and show me the diff.
    AI chat with the Clew prompt in the message box (paywall upgrade prompt in a v0 app)
    Step 3 · schematic illustration
  4. Step 04

    Check layout.tsx and deploy

    Expect a <Script> element in app/layout.tsx. Then Deploy to Vercel and open the production URL.

    Code diff with a Script component added to the root layout (paywall upgrade prompt in a v0 app)
    Step 4 · schematic illustration
  5. Step 05

    Write the upgrade prompt

    In Clew open Flows → + New flow and choose Modal window. One step: a title with the benefit (“Export to CSV is on Pro”), one sentence of value, and in Link text / Link URL the button and your pricing or checkout URL.

    An upgrade prompt modal over a web app, with a benefit headline and a link button to the pricing page (paywall upgrade prompt in a v0 app)
    Step 5 · schematic illustration
  6. Step 06

    Choose where, when and for whom it shows

    In the same editor, set Where to show (page URL), When to show, Audience targeting and Frequency. These are the settings of the example above:

    SettingValue
    FormatModal window
    Where to show (page URL)Section by prefix /dashboard/reports
    When to showOn click on an element: [data-tour="export-csv"]
    Audience targetingProperty plan equals free
    FrequencyEvery visit
    Clew tour editor with the format, page URL rule, trigger and audience rule fields (paywall upgrade prompt in a v0 app)
    Step 6 · schematic illustration
  7. Step 07

    Publish and check it on the live site

    Set Status to Published and save. Open the page in a private window — Clew remembers who has already seen a “once” item, so your usual browser may skip it. Views, completions and drop-offs appear in the tour stats.

    Clew admin Overview with the green “Widget is live” card (paywall upgrade prompt in a v0 app)
    Step 7 · schematic illustration

Pitfalls: paywall upgrade prompt in a v0 app

Server components can’t call identify

Clew.identify() runs in the browser. It belongs in a client component ("use client") that has the session, not in a server component or layout.

Wait for data before pointing at charts

Dashboards render placeholders first. Anchor steps to headings and buttons, or use After N seconds of a couple of seconds so the paywall upgrade prompt appears after the data.

The prompt doesn’t replace access checks

If the paid feature is reachable for free users in your app, the modal appears but the feature still works behind it. Check that the server side enforces the plan; the prompt is only the message.

Update the property after upgrading

Properties live in the browser until the app sends a new value. Call Clew.identify({ plan: "pro" }) after a successful upgrade, or the new customer keeps seeing the prompt.

Questions and answers

Where should the plan property be set?

In a client component with the session, right after it loads.

Why not a plain script tag in v0?

In the App Router, next/script is the supported way to add third-party scripts; a raw tag in a component may render twice or not at all.

Does Clew take the payment?

No. The button links to your own pricing page or checkout; Clew never handles cards, subscriptions or access.

Is the paywall prompt free?

It needs the modal format and an audience rule, both in Pro. The 14-day trial includes them, no card.

One line on your site — then tours, tooltips and checklists without releases.

Get your site key — freeHow Clew worksFree plan forever, no credit card

Product tours, popups and onboarding in the age of AI

7 patterns with step counts, copy rules and what to measure, what AI changes, and a checklist before you publish. PDF, 2 pages. What is inside →