Flutter Tooltip Tutorial

In Flutter, Tooltip widget is a material design tooltip used to let user know about the functionality of a button or UI action.

When a widget is equipped with tooltip, if user long presses the widget or some appropriate action on the widget, tooltip appears as a floating label.

Tooltip is usually used to increase the accessibility of your application, providing text based clues for visual based widgets.

The Tooltip widget in Flutter has the following syntax:

  Key? key,
  required String message,
  double? height,
  EdgeInsetsGeometry? padding,
  bool preferBelow = true,
  double? verticalOffset = 24.0,
  Decoration? decoration,
  TextStyle? textStyle,
  Duration showDuration = const Duration(milliseconds: 1500),
  Duration hideDuration = const Duration(milliseconds: 200),
  Widget? child,

Here’s a brief explanation of the parameters:

  • Key? key: An optional key that represents a specific instance of the Tooltip widget.
  • required String message: The text message that appears inside the tooltip.
  • double? height: The height of the tooltip. If not specified, the height adjusts based on the content.
  • EdgeInsetsGeometry? padding: The padding around the content of the tooltip.
  • bool preferBelow: If true, the tooltip will prefer to display below the child widget; otherwise, it can display above.
  • double? verticalOffset: The vertical offset to adjust the position of the tooltip.
  • Decoration? decoration: The decoration of the tooltip’s background.
  • TextStyle? textStyle: The text style of the tooltip’s message.
  • Duration showDuration: The duration for which the tooltip is shown when triggered.
  • Duration hideDuration: The duration for the tooltip’s fade-out animation.
  • Widget? child: The widget that the tooltip will be applied to.

Remember that the message parameter is the only required one. You can adjust other parameters based on your design and user experience preferences.

Here’s a basic example of using the Tooltip widget:

  message: 'This is a tooltip message',
  child: ElevatedButton(
    onPressed: () {},
    child: Text('Hover over me'),

Example – Flutter Tooltip

In your main.dart, create a simple Tooltip widget. Let’s use a FlatButton as an example:

void main() {

class MyApp extends StatelessWidget {
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Tooltip Tutorial',
      home: MyHomePage(),

class MyHomePage extends StatelessWidget {
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('Tooltip Example')),
      body: Center(
        child: Tooltip(
          message: 'Click me!',
          child: FlatButton(
            onPressed: () {
              // Add your button's onPressed logic here
            child: Text('Hover over me'),

In this example, we’ve wrapped a FlatButton widget with a Tooltip widget. The message parameter of the Tooltip specifies the text that will be displayed in the tooltip.

Customizing Tooltips

Customizing Tooltip Appearance:
You can customize the appearance of tooltips using the Tooltip widget’s properties. For instance:

height and padding control the visual dimensions.
preferBelow and verticalOffset control the tooltip’s position.

  message: 'Custom Tooltip',
  height: 40,
  padding: EdgeInsets.all(10),
  preferBelow: false,
  verticalOffset: 40,
  child: // Your widget here,


You’ve learned how to create tooltips in Flutter using the Tooltip widget. Tooltips are a great way to enhance the user experience by providing additional context to your app’s UI elements.

Feel free to embellish your blog post with screenshots, code snippets, and further explanations. Happy coding and writing!

Related Posts

Flutter ToggleButtons Tutorials

Basic of Flutter Slider Widget

The Basics of Flutter Scaffold

Flutter’s Row Widget Tutorial

Flutter RangeSlider Widget Tutorial

Creating a Radio Widget in Flutter

Leave a Comment