What Are Tooltips?
Tooltips are small pop-ups that appear when customers hover over (or tap on mobile) a feature name. Perfect for:
- Explaining technical features
- Providing additional context
- Answering common questions
- Keeping table clean while offering details
When to Use Tooltips
Good Use Cases
- Technical features: "What is SSO?" → Tooltip: "Single Sign-On lets users log in once to access multiple apps"
- Acronyms: "API calls" → Tooltip: "Application Programming Interface - allows third-party integrations"
- Limits: "Premium support" → Tooltip: "24/7 phone & email support with 1-hour response time"
- Complex features: "Advanced analytics" → Tooltip: "Custom dashboards, data exports, and predictive insights"
Don't Use Tooltips For
- Simple features everyone understands ("Email support")
- Features that need long explanations (use a comparison table instead)
- Critical information (put that in main feature text)
Adding Tooltips
1 Find Tooltip Field
When adding a feature, look for the Tooltip Text or Help Text field.
2 Write Clear Tooltip
Keep tooltips:
- Concise: 1-2 sentences max
- Clear: Use plain language
- Helpful: Answer the question "What is this?"
Example tooltips:
Feature: "Custom domain"
Tooltip: "Use your own domain name (yourcompany.com) instead of ours"
Feature: "White label"
Tooltip: "Remove our branding and add yours for a professional look"💡 Writing Tip: Imagine a customer asking "What's this?" - your tooltip should answer that in one sentence.
Tooltip Best Practices
- Icon indicator: Show ⓘ or ? icon so users know to hover
- Mobile friendly: Tooltips should work on tap, not just hover
- Contrast: Ensure tooltip text is readable
- Positioning: Tooltips shouldn't cover other important content
Styling Tooltips
Customize tooltip appearance:
- Background color: Match your brand
- Text color: High contrast for readability
- Arrow: Point to the feature name
- Width: Not too narrow (hard to read) or wide (blocks content)