Skip to main content






Applies only to Mobile Apps and Reactive Web Apps




  • 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.

    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 Record 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?