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 Separator UI Pattern to separate content clearly and ease visual organization.

    Separator widget example

    How to use the Separator UI Pattern

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

      The Separator 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 Separator widget into the Main Content area of your application's screen, where you want to separate content. In this example, we drag the widget in between 2 images.

      Drag widget to screen

      By default, the pattern displays a horizontal line with the application’s primary color.

    3. On the Properties tab, you can customize the Separator's look and feel by setting any of the optional properties, for example, the color and the amount of space separating the content.

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


    Property Description
    Color (Color Identifier): Optional Set the color for the separator line. Red, orange, yellow, lime, green, blue, violet, and pink are just some of predefined colors available for the badge.


    • Blank - Displays a gray (Neutral4) line (default value).
    • Entities.Color.Red - Displays a red line.
    Space (Space Identifier): Optional Set the space around the separator line. The predefined vales are:

    • None
    • Extra small
    • Small
    • Base
    • Medium
    • Large
    • Extra large
    • Extra extra large


    • Blank - Displays a space of 16px (Entities.Space.Base) around the line separator. This is the default value.
    • Entities.Space.Large - Displays a space of 32px around the line separator.
    IsVertical (Boolean): Optional If False, the separator line displays horizontally (default). If True, the separator line displays vertically.
    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 Live Style Guide.
    • Was this article helpful?