Share video content with support for multiple videos, captions, and metadata. Video posts support up to 10 videos per post with automatic thumbnail generation and rich text descriptions.

Multi-Video Support

Upload up to 10 videos per post with automatic thumbnails

Large File Support

Support for videos up to 2GB and 2 hours duration each

​
Overview

Video posts combine visual storytelling with descriptive text:
  • Multiple Videos: Up to 10 videos per post
  • Rich Captions: Text descriptions with mentions and hashtags
  • File Size Limit: Up to 2GB per video
  • Duration Limit: Maximum 2 hours per video
  • Format Support: Wide range of video formats
  • Parent-Child Structure: Each video becomes a child post
RequirementLimitNotes
File SizeUp to 2GB per videoPlatform may have lower limits
DurationMaximum 2 hoursPer individual video
Video CountMaximum 10 videosPer single post
File Formatsmp4, mov, avi, mkv, webm, flv, 3gp, wmv, vob, ogv, 3g2, f4v, m4vPlatform dependent
HDR video format uploads are not supported on iOS platform.
Videos must be uploaded first before creating the post. See Video Handling for upload instructions.
1

Upload Videos

Use the File Repository to upload your video files and get file IDs
2

Create Post

Use the file IDs in your post creation request with captions
3

Handle Response

The post will contain parent and child posts for each video
4

Monitor Progress

Track video processing and thumbnail generation status

​
Parameters

ParameterTypeRequiredDescription
textString✅Caption text (max 20,000 characters)
videos/videoFilesArray✅Video files or uploaded video data
targetTypeEnum✅Target type (user or community)
targetIdString❌Target ID (null for own feed)
tagsArray<String>❌Tags for categorization
metadataObject❌Custom metadata
func createVideoPostExample(videos: [AmityVideoData], text: String) async {
    // Build your post structure
    let builder = AmityVideoPostBuilder()
    builder.setText(text)
    builder.setVideos(videos)
    // Create a post from the builder
    do {
        let post = try await postRepository.createVideoPost(builder, targetId: nil, targetType: .user, metadata: nil, mentionees: nil)
    } catch {
        // Handle error here
    }
}

​
Troubleshooting

​
Common Use Cases

  • Video Sharing: Share personal videos and memories
  • Tutorials: Create step-by-step instructional content
  • Live Updates: Share real-time event footage
  • Product Demos: Showcase products in action
  • Entertainment: Share funny clips and entertainment content
  • Educational Content: Distribute learning materials and lectures

Video Handling

Learn how to upload and manage video files before creating posts

Image Posts

Create posts with photos and visual content

Live Streaming

Create real-time video broadcasts and live content