Unify Integrations
Logo
Media

Media

Logo

3 mins READ

Overview

The Media component helps you visually present files like images, videos, or audio within your application. It supports both static and dynamic data sources, making it flexible for showcasing galleries, media lists, or any visual content from external links or data collections.

By configuring its properties, you can control the layout, appearance, and behavior of media elements to create a rich user experience.

Master - Do not Edit (39).png
Master - Do not Edit (39).png

Standard Actions

Content

The Media component provides several options to customize the media presentation. Type


Define how you want to add media to your component:

PropertyDescription
MappedAdd media dynamically from a data source as shown in the image below.
StaticAdd media manually using an array of URLs. For example ({{ [ "Link1", "Link2", "Link3"]}}

Data

Provide URLs or a data source to populate the component with media items.

PropertyDescription
MappedAdd media dynamically from a data source as shown in the image below.
StaticAdd media manually using an array of URLs. For example ({{ [ "Link1", "Link2", "Link3"]}}

Mapped Media

Dynamically link and display media based on your data source.

Fields to configure:

PropertyDescription
IDUnique identifier assigned to each media item for tracking and referencing.
NameDescriptive label or title to easily recognize the media file.
URLDirect path to access and render the media file (image, video, or audio).
CaptionBrief text providing context or description of the media.
MIME TypeSpecifies the format of the media file (e.g., image/jpeg, video/mp4) to ensure correct handling.
LoadingIndicates the loading state of the media while it is being fetched, improving the visual experience.
Master - Do not Edit (40).png
Master - Do not Edit (40).png

Appearance

  1. Display:  Choose how the media items are presented:

    • List: Display media in a vertical list format for a more detailed view.

    • Grid: Arrange media in a grid layout for a clean, organized look.

  2. Variant: Select the spacing style for your media layout

    • Spacious: Enlarges the images, creating a more open and airy layout.

    • Compact: Arranges media items closely for a condensed view.

  3. Size : Adjust the dimensions of the media items for optimal display. (For example: xs, sm, md, lg)

  4. Maximum Visible Items : Set the maximum number of media items to be displayed at once.

  5. Show Caption : Enable to display captions alongside the media for additional context.

Master - Do not Edit (41).png
Master - Do not Edit (41).png

Above showing different types of appearance media component can be used for.

Typical Use Cases

  • Display product images in an e-commerce application.

  • Show user profile pictures in a contact or employee directory.

  • Embed promotional or tutorial videos in your app.

  • Render document previews (PDFs, images, etc.)

  • Showcase banners, ads, or dynamic posters.

FAQs

Can I use both images and videos in the Media component?

Yes, the Media component supports multiple media types including images, videos, and audio files. Make sure to specify the correct MIME Type for proper rendering.

What happens if the media URL is broken or the file is missing ?

It’s recommended to provide a fallback image or meaningful caption to handle missing or broken media gracefully.

Can I map media dynamically from my data source?

Yes, you can select Mapped type and bind fields like URL, Name, Caption, and MIME Type directly from your data source.

How does the "Loading" property improve performance?

The "Loading" property allows you to show a placeholder while the media is being fetched, enhancing user experience and preventing empty spaces during loading.