Skip to main content




Applies only to Mobile Apps and Reactive Web Apps
Service Studio version:


  • Edit
    Collaborate with us
    Edit this page on GitHub
  • If you are using an OutSystems UI version lower than 2.8.0, please see the Patterns and Versions Overview.

    You can use the Tooltip UI Pattern to dynamically display informative text when a user hovers over, clicks, or taps an on-screen element.

    Example tooltip

    How to use the Tooltip UI Pattern

    1. In Service Studio, in the Toolbox, search for Tooltip.

      The Tooltip widget is displayed.

      Tooltip widget

      If the UI widget does not display, it may be because you used a ready-made app, which deletes unused widgets from the module. To make additional widgets available in your app:

      a. Go to Module > Manage dependencies.

      b. Search for and select the relevant Producer, for example OutSystemsUI. Ensure Show All is selected.

      c. On the Public elements for the selected Producer displayed on the right, ensure Show All is selected.

      d. Search for and select the element you want to add, and click Apply.

      e. In Service Studio, in the Toolbox, search for the widget again.

    2. To From the Toolbox, drag the Tooltip widget into the Main Content area of your application's screen.

      Drag tooltip to screen

      By default, the Tooltip widget contains Content and Tooltip placeholders.

    3. Add your content to the placeholders.

      In this example, we add a Save button to the Content placeholder and enter the tooltip text 'Save your details' in the Tooltip placeholder.

      Add content to tooltip

    4. On the Properties tab, from the Position dropdown, select where you want the tooltip to appear. In this example we want the tooltip to appear on top of the Save button. You can also change the look and feel of the Tooltip by setting the (optional) properties.

    After following these steps and publishing the module, you can test the pattern in your app.


    Properties Description
    Position ( Position Identifier): Optional Set the tooltip's position. The predefined options are:
    • Bottom
    • BottomLeft
    • BottomRight
    • Center
    • Left
    • Right
    • Top
    • TopLeft
    • TopRight


    • Entities.Position.Right - The tooltip is displayed to the right of the element.
    • Entities.Position.Bottom - The tooltip is displayed underneath the element.
    StartsOpen (Boolean): Optional If True, the tooltip is visible when the page is first loaded (without the need for the initial trigger). If False, the tooltip is not visible. This is the default.
    Trigger (TriggerIdentifier): Optional Set how the tooltip is triggered. By default, the tooltip is triggered by hovering over the element.
    ExtendedClass (Text): Optional Adds custom style classes to the Pattern. You define your custom style classes in your application using CSS.


    • Blank - No custom styles are added (default value).
    • "myclass" - Adds the myclass style to the UI styles being applied.
    • "myclass1 myclass2" - Adds the myclass1 and myclass2 styles to the UI styles being applied.
    You can also use the classes available on the OutSystems UI. For more information, see the OutSystems UI Framework Cheat Sheet.
    • Was this article helpful?