Skip to main content
Video posts combine uploaded videos with an optional text caption. Upload the videos first, then pass the uploaded video objects or file IDs to the post creation API.
This page focuses on the SDK call that creates the post. See Video Handling for upload steps, supported file inputs, processing behavior, and upload constraints.

Uploaded Videos

Create posts from video objects or file IDs returned by the file upload flow.

Caption Support

Add text, metadata, mentions, or other SDK-supported post fields alongside the videos.

Parameters

Product tags (SDK API). A video post has a text parent and a video child. productTags tags products mentioned in the parent text. attachmentProductTags tags products on the child media attachment, and is not an array: it is an AmityAttachmentProductTags container that maps each attachment’s fileId to that attachment’s media tags. Flutter does not expose product tags on any post builder. See Tag Products below for both. UIKit’s product-tag UI is a separate surface and may support fewer post types; see UIKit Product Tagging. For tagging limits and tap-through behavior, see Product Tagging.

Create a Video Post

The examples below create a video post in a community. Replace the target with the SDK’s user-feed target when posting to a user.

Tag Products

TypeScript, Android, and iOS accept two separate product inputs when creating a video post. The text tag is applied to the parent; the attachment tag is applied to the video child. Build attachmentProductTags by setting the tags for each uploaded video’s fileId. Videos you do not set tags for stay untagged.

Notes

  • TypeScript accepts video attachments as { type: "video", fileId }.
  • Android accepts a Set<AmityVideo>.
  • iOS accepts [AmityVideoData].
  • Flutter accepts List<AmityVideo>.
For mixed attachment types, use Mixed Media Posts.

Video Handling

Upload videos before creating video posts.

Clip Posts

Create short-form clip posts where supported.

Mixed Media Posts

Combine videos with other supported media attachments.