You’re about to sign a message. This allows the dApp to interact with your wallet.Gas fees are payments made to validators for processing transactions.Click here to stake your tokens. Staking involves locking your tokens to support the network.”
That’s not help. That’s cleanup.
Most tooltips in Web3 don’t inform, they explain what the interface failed to.
If You Need a Tooltip, You Already Missed
Tooltips are supposed to augment UI. Instead, they’ve become life support. Designers add them when:
A button label makes no senseThe action has unintended consequencesThe flow feels risky, but no one fixed itLegal asked for a disclaimer, and nobody pushed back
They’re not signs of “educating the user.” They’re evidence the UI didn’t do its job.
Language as a Crutch
Take a moment to count how many tooltips are just definitions:
“A validator is a node that verifies blocks.”
“Staking locks your assets for a period of time.”
“This message is off-chain and doesn’t require gas.”
Now ask:
Why did the interface not communicate that in the first place? It’s the same as walking into a room and needing labels on every piece of furniture.
At some point, you didn’t design the room. You just labeled the mess.
The Danger of Tooltip-Driven Design
What starts as a temporary patch becomes permanent UX debt. Designers lean on tooltips to:
Avoid confronting hard UX questionsDefer decisions on clarityShip faster without explaining the mental model
But users don’t build trust with popups. They build it through predictable, self-evident interfaces.
What to Do Instead
Make labels do more work.
“Sign” → “Sign to approve connection”Show context instead of hiding it.
If a flow has gas fees, show how and why — not just a dollar amount with a hover explanation.Design actions that don’t need explaining.
A single clear button trumps 3 ambiguous ones with popovers.Use progressive disclosure.
Layer depth when it’s wanted, not by default.
Exceptions Prove the Rule
Yes, sometimes tooltips are necessary:
Explaining uncommon behaviorOffering deeper insights for power usersRevealing helpful keyboard shortcuts or accessibility aids
But if every step needs a disclaimer, the design isn’t accessible — it’s hiding behind a glossary.
UX Is Not What You Say About the UI
The best interfaces feel intuitive not because they were “simple.” But because they made language and structure do the heavy lifting.
A tooltip should never carry more clarity than the button itself. Otherwise, it’s not a feature — it’s a confession.
Are Tooltips UX or Confessions? was originally published in Coinmonks on Medium, where people are continuing the conversation by highlighting and responding to this story.