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
  • You can use the Gallery UI Pattern to display groups of content. This UI pattern allows users to sequentially browse images, with the notion of a beginning and an end.

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

      The Gallery widget is displayed.

      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. From the Toolbox, drag the Gallery widget into the Main Content area of your application's screen.

    3. Add the required content to the Gallery widget.

      By default, the Gallery widget expects a list.

      To use the Gallery UI Pattern with items from a database, drag a List into the Gallery widget and create your custom content.

      In this example, we delete the list and add local images to the Gallery widget.

    4. On the Element tree, select the Image widget, and on the Properties tab, from the Image drop-down, select or import the image you want in the Gallery.

      Note: In this example, the image property Type is set to Local image. You can also add External and Binary Data images.

    5. On the Properties tab, set the relevant (optional) properties, for example, the number of items you want to display on each device (see below for examples) and the space between each item (GutterSize).

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

    4 items per row

    3 items per row

    2 items per row

    1 item per row


    Property Description
    ItemInPhone (Integer): Optional Number of items displayed on a phone.


    • Blank - 1 item is displayed. This is the default value.
    • 2 - 2 items are displayed.
    ItemsInTablet (Integer): Number of items displayed on a tablet.


    • Blank - 3 items are displayed. This is the default value.
    • 2 - 1 item is displayed.
    ItemsInDesktop (Integer): Number of items displayed on a desktop.


    • Blank - 4 items are displayed. This is the default value.
    • 3 - 3 items are displayed.
    GutterSize (Space Identifier): Optional Defines the space between the items. The predefined sizes are:

    • None
    • Extra Small
    • Small
    • Base
    • Medium
    • Large
    • Extra Large
    • Extra Extra Large


    • Blank - A space of 16px between each item. This is the default value (Entities.Space.Base).
    • Entities.Space.Large - A space of 32px between each item.
    • Was this article helpful?