PLAYBOOKAll posts

Crypto Wallet Onboarding UX Copy: Fixing the Four Friction Points

Wallet onboarding copy is the cheapest fix for crypto drop-off. Before and after microcopy for seed phrases, gas fees, signing requests and the empty wallet.

Shilika Jain in a pink dress and sunglasses on the Singapore River at dusk
On this page12
  1. Why is wallet onboarding copy so often the problem?
  2. The four friction moments in wallet onboarding
  3. How should you write seed phrase and backup copy?
  4. How do you explain gas fees and signing requests in plain words?
  5. A copy audit you can run in an afternoon
  6. Where does copy stop and product take over?
  7. The trade-offs of simpler wallet copy
  8. FAQ
  9. Should wallet onboarding copy avoid the word "blockchain" entirely?
  10. How long should microcopy on a wallet screen be?
  11. Can onboarding copy improve press coverage?
  12. Who should own wallet copy inside a startup?

Crypto wallet onboarding copy should tell a new user what's happening, why it matters to them, and what to do next, in words they already know. Most drop-off clusters around four moments: backing up the recovery phrase, the first network fee, the first signing request and the empty wallet after setup. Rewriting the copy on those four screens is usually the cheapest onboarding fix you can ship, because it needs a writer and a designer, not a new architecture.

It won't fix a broken flow. It will stop you losing people who were willing to continue but couldn't understand the screen in front of them.

Why is wallet onboarding copy so often the problem?

Because it's written by the people who least need it. Engineers and protocol designers write the first draft of most wallet screens, and they write it in the vocabulary of the system: derivation paths, nonces, approvals, gas. Every word is accurate. Very few of them mean anything to a first-time user.

I've worked on PR for wallet and onboarding infrastructure, including Web3Auth, whose MPC wallet work and wallet convenience tech were aimed squarely at this gap. One of the stories we ran was a Web3Auth adoption report that Cryptonews covered under the headline "Security concerns and high costs top obstacles in Web3 adoption." Those two obstacles, fear and cost, map almost exactly onto the screens where copy fails. You can read more on the Web3Auth case study.

The goal most teams are working towards is a wallet that disappears into the experience:

the true chain abstraction moment happens when a user uses your dapp without knowing which chain you're built on! Shilika Jain on X, 25 Sep 2024

Not every product can get there yet. Copy is how you get closer while the infrastructure catches up.

The four friction moments in wallet onboarding

Here's the framework I use when I audit a wallet or dapp flow. Each moment has a fear the user brings to it, a common copy mistake, and a better pattern.

MomentWhat the user is afraid ofTypical copyBetter copy pattern
Recovery phrase backupLosing everything, or doing it wrong"Write down your 12-word mnemonic seed phrase. Never share it.""These 12 words are the only way back into your wallet if you lose this phone. Write them on paper and keep them somewhere safe. Anyone who has them can take your funds."
First network feeBeing overcharged or tricked"Estimated gas: 0.0004 ETH""Network fee: about $0.90. This goes to the network that processes your transaction, not to us."
First signing requestSigning something dangerous"Signature request. Message: 0x7a9f...""This app wants to confirm it's really you. Signing this doesn't move any money."
Empty wallet after setup"Now what?""Your balance: 0.00""Your wallet is ready. Add funds to get started, or receive from a friend using your address below."

The dollar figures and wording are illustrative, not from a specific product. Use your own real fee estimates and your own legal review.

Notice the pattern across all four rows. The better copy answers three things in order: what this is, what it means for you, what to do. And it names the risk honestly instead of hiding it.

How should you write seed phrase and backup copy?

This is the screen where honesty and simplicity pull hardest against each other. You can't make a recovery phrase sound harmless, because it isn't. You can make it understandable.

A few rules I'd hold every team to:

  • Call it what it does before you name it. "The only way back into your wallet" first, "recovery phrase" second. Many users have never heard "seed phrase" and the word "seed" means nothing to them.
  • Pick one term and stick to it. Seed phrase, recovery phrase, secret phrase, mnemonic. If three screens use three names, users assume they're three different things.
  • State the consequence plainly. "Anyone who has these words can take your funds" is scarier than "Never share your seed phrase", and it's also clearer. Clear wins here.
  • Tell them where, not just what. "Write them on paper" is more useful than "store them securely", which means nothing to a beginner.
  • Don't punish them with a test immediately. If you make users re-enter the words to confirm, explain why first: "We'll check you've got them right so you're not locked out later."

I made a related point in my Tangem marketing teardown: self-custody tools are competing with how easy everyday payment apps feel. Tangem's own survey, which we turned into a data story in 2026, found around two-thirds of crypto users support self-custody while cold-wallet adoption sat around 15 percent. That gap between belief and action is where onboarding copy either helps or loses people.

How do you explain gas fees and signing requests in plain words?

Translate units into money and actions into consequences.

For fees, a user doesn't think in gwei or fractions of a token. They think in their own currency. Show the local-currency estimate first and the token amount second, if at all. Then answer the question they're actually asking, which is who gets this money.

For signing requests, the fear is specific: "am I about to give this app my funds?" Your copy should answer that before anything else. Split signing requests into plain categories and say which one this is:

  1. Confirming it's you. Logging in. No money moves.
  2. Sending something. Money or tokens leave your wallet. Show the amount.
  3. Giving permission. An app can move a specific token on your behalf. Say which token, how much, and how to revoke it later.

That third category is where users get hurt, and it's where copy matters most. "Approve unlimited USDC spending" is technically correct. "Let this app move any amount of your USDC, now and later, until you turn it off" is what it means. If that sentence makes the user hesitate, good. Hesitation is the right response.

A copy audit you can run in an afternoon

You don't need a research budget for a first pass. Here's the sequence I use.

  1. Screenshot every screen from app install to the first successful transaction. Put them in a single board in order.
  2. Circle every word a newcomer must already know to understand the screen. Gas, sign, chain, network, approve, slippage, RPC, bridge, mainnet.
  3. Mark the four friction moments from the table above and give them priority.
  4. Rewrite each circled screen using the pattern: what this is, what it means for you, what to do.
  5. Hand the new flow to three people outside crypto and watch them go through it without helping. Note every pause.
  6. Fix the pauses, then ship. Re-run the test whenever you add a screen.

Step 5 is the one teams skip and the one that matters most. The person who wrote the copy can't see what's confusing about it.

If you want help building the word list for step 2, the crypto jargon cut list has plain replacements for most of the usual terms.

Where does copy stop and product take over?

Copy has limits, and pretending otherwise wastes time.

If a user needs to buy a gas token on a separate exchange before they can do anything, no sentence fixes that. If the signing prompt comes from a third-party wallet you don't control, you can only prepare the user before it appears, not rewrite it. And if your flow has nine steps, better words on each step still leave nine steps.

That's why I keep pointing teams towards the work happening below the interface. I did an interview with Reown on this subject in 2025:

Did a super cool interview w @houlgrave from @reown_ on how they're tackling one of the biggest web3 problems & Reown's initiatives on making onchain UX invisible! Shilika Jain on X, 27 May 2025

Invisible UX is the destination. Clear copy is what you do in the meantime, and it's also what you'll still need when something goes wrong, because error states, failed transactions and security warnings will always need words.

The trade-offs of simpler wallet copy

Simplifying has real costs, and you should decide them on purpose.

  • Accuracy versus clarity. "Network fee" hides the difference between base fee and priority fee. For most users that's fine. For power users, offer an "advanced details" toggle instead of cluttering the default view.
  • Calm versus caution. Making screens feel friendly can make dangerous actions feel routine. Keep friendly copy for safe actions and deliberately firmer copy for approvals and anything irreversible.
  • Crypto-native users. If your users are experienced DeFi traders, over-explaining slows them down and reads as patronising. Segment: plain copy by default, with experienced users able to skip explanations.
  • Legal and compliance review. Plain language about risk sometimes needs legal sign-off in a way that vague language doesn't. Budget time for it.

When positioning work comes up in a Web3 PR campaign, I push teams to write these decisions into a short copy guide so every new screen, help article and press answer follows the same rules.

FAQ

Should wallet onboarding copy avoid the word "blockchain" entirely?

Not always, but it rarely needs to be on onboarding screens. Users need to know what to do and what's at stake, not what the system is called. Save the term for help articles and settings pages.

How long should microcopy on a wallet screen be?

As short as possible while still answering what, why and what next. On high-risk screens like approvals, a longer sentence that states the consequence clearly is worth the extra words.

Can onboarding copy improve press coverage?

Indirectly, yes. Reporters who test your product hit the same screens users do, and a confusing first-run experience shows up in how they describe you. A clear flow also gives you a credible story about user experience to pitch.

Who should own wallet copy inside a startup?

One person with final say, usually in product or marketing, working from a shared glossary. Without an owner, every engineer names things slightly differently and the inconsistency confuses users more than any single bad screen.

If your wallet flow loses people at the recovery phrase screen, send me the screenshots and I'll mark where the words are doing the damage.

Shilika Jain wearing a conference badge on the Marina Bay promenade in Singapore

Work with Shilika

Book a 30-min intro call.

I come prepped with a teardown of your current press footprint.

Keep reading

Similar playbooks

01

Airdrops vs Real Users and Why Forced Onchain Activity Fails

Why incentive-forced onchain activity attracts airdrop farmers instead of real users, how to spot the difference, and what Web3 teams should do instead.

Read playbook
02

Most Crypto Companies Have an Explanation Problem

Why narrative, not technology, decides which crypto projects get users and press, with chain examples and a practical way to build and repeat your own.

Read playbook
03

Tangem Marketing Teardown: Sell Ownership, Not Hardware

My marketing teardown of Tangem: why its real competitor is centralized exchanges, and the campaign ideas I would run to sell ownership, not hardware.

Read playbook
All playbooks