Skip to main content
Our new developer certification is live!

Media

Component for displaying media assets (images) with optional title and description.

Props

PropTypeRequiredDefaultDescription
titlestringNo-Media title
descriptionstringNo-Media description
assetFileYes-Media asset from Contentstack
$CSLPFieldMappingNo-CSLP mapping for editable fields
prioritybooleanNofalsePreloads the image when used above the fold
sizesstringNo-Optional sizes attribute override for responsive images

Usage

import { Media } from '@/components/organisms/Media';

<Media
  title="Product Screenshot"
  description="Our new dashboard interface"
  asset={{
    url: "/images/dashboard.jpg",
    title: "Dashboard",
    dimension: { width: 1200, height: 800 }
  }}
/>

Features

  • MediaItem integration: Uses MediaItem component for optimized images
  • Optional metadata: Title and description are optional
  • Aspect ratio: Calculates from asset dimensions or defaults to 16:9
  • CSLP support: Contentstack Live Preview editing

Notes

  • Returns null if no asset is provided
  • Uses MediaItem component for image rendering
  • Aspect ratio calculated from asset dimensions if available
  • Title renders as h3 if provided
  • priority and sizes are typically injected by ComponentsRenderer for above-the-fold media