Configure a media UI section

  • Release version: Zurich
  • Updated July 31, 2025
  • 3 minutes to read

    • Configure a media UI section type to display images or videos on your launcher screen.

    Before you begin

    Role required: admin

    Procedure

    1. Navigate to All > System Mobile > Mobile App Builder.
      The Mobile App Builder opens in a new browser tab and displays the application scope selection screen.
    2. Search for the application scope you are working in and then select the name of the application scope.
      The Mobile App Builder categories home screen displays.
    3. Select All mobile records from the menu.
    4. From the Record type list, select Media Section [sys_sg_media_section], and then select New.
    5. On the form, fill in the fields.
      Table 1. Media UI section form
      Field Value
      Title Title for your media UI section
      Headline Headline for the media UI section. This headline appears below your image or video.
      Text Text for the media UI section. This text appears below the text of your headline.
      Type Type of media UI section select one of the following:
      • Image
      • Video
      Active Whether the record is active. Inactive records do not display in your app.
      Media file

      • If you set the Type field to Image:

        Select Choose image to select an image from your file system.
        Note:

        Create images optimized for use in media UI sections by using a height of 160px and a width of 1366px.

        If your users primarily use iPhones, use a height of 160px and a width of 375px to 600px.

      • If you set the Type field to Video:

        Enter the Video URL.
      Media section function instance

      Select the function instance that is used when a user taps on the media UI section. The label of your function appears below the text specified for the Text field.

      Note:

      The selected function instance must meet the following requirements:

      • The Parent table field must contain entries, before selecting the Parent field.
      • The Parent table field must be set to Screen Launcher.
      • The Parent field of the selected function instance must be the launcher where you intend to add your media UI section.
      • The Location field of the function instance must be the Media UI Section.
      Access control type Option to assign either user role permissions or user criteria permissions for this launcher screen. For more information, see User roles and user criteria permissions for mobile apps.
      Role access

      Determines which user roles can access this launcher screen. If you have selected no roles, users with any role have access to the launcher screen.

      Note:
      This field is available when User roles is selected in the Access control type field.
      User criteria access

      Determines the criteria a user must meet to access the record on their mobile device. If you don't select any criteria, all users have access to the launcher screen.

      Note:
      This field is available when User criteria is selected in the Access control type field.
    6. Select Save.
      You have a configured media UI section that you can add to a launcher screen.
      Media section showing the positions of the Image/Video, headline, and text elements
    7. Add your UI section to a launcher screen:
      1. Select the home icon to navigate to the Mobile App Builder home screen.
      2. Select Screens in the menu.
      3. Open the launcher screen record where you want to add your UI section.
      4. In the Launcher Sections area, select Choose, then select the media UI section you created in Step 6, and then select Apply.
      5. In the Order field, enter a number representing the order in which the UI section is displayed on the screen launcher, and then select the green check.
        UI sections appear on the launcher from the lowest order to the highest.
      6. After you have added your media UI section, select Save to save the launcher screen record.

    What to do next

    After creating media UI sections, you must associate the UI sections to a launcher screen so they're displayed. For more information, see Add a UI section to the launcher screen.