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.
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
- 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>

Step 1 · schematic illustration - 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.
Step 2 · schematic illustration - Step 03
Send the prompt with your key
Replace
PASTE_YOUR_SITE_KEYwith your key and send the prompt. It usesnext/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.
Step 3 · schematic illustration - Step 04
Check layout.tsx and deploy
Expect a
<Script>element inapp/layout.tsx. Then Deploy to Vercel and open the production URL.
Step 4 · schematic illustration - 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.

Step 5 · schematic illustration - 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:
Setting Value Format Modal window Where to show (page URL) Section by prefix /dashboard/reportsWhen to show On click on an element: [data-tour="export-csv"]Audience targeting Property planequalsfreeFrequency Every visit 
Step 6 · schematic illustration - 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.

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.
What else you can add in a v0 app
- How to create a product tour in a v0 app without a developer
- How to add an onboarding checklist in a v0 app without a developer
- How to set up user onboarding in a v0 app without a developer
Paywall prompt on other platforms
- ShopifyHow to add a paywall upgrade prompt on Shopify without a developer
- Google Tag ManagerHow to add a paywall upgrade prompt via Google Tag Manager without a developer
- LovableHow to add a paywall upgrade prompt in a Lovable app without a developer
- Bolt.newHow to add a paywall upgrade prompt in a Bolt.new app without a developer
- ReplitHow to add a paywall upgrade prompt in a Replit app without a developer
- CursorHow to add a paywall upgrade prompt in an app built with Cursor without a developer
- Claude CodeHow to add a paywall upgrade prompt with Claude Code without a developer
- ChatGPT CodexHow to add a paywall upgrade prompt with ChatGPT Codex without a developer
- Qwen CodeHow to add a paywall upgrade prompt with Qwen Code without a developer