Share visual content with support for multiple images, captions, and metadata. Image posts support up to 10 images per post with rich text descriptions.

Multiple Images

Upload up to 10 images per post with individual reactions

Rich Media Support

JPEG, PNG, WebP formats up to 100MB per image

​
Overview

Image posts combine visual content with descriptive text:
  • Multiple Images: Up to 10 images per post
  • Rich Captions: Text descriptions with mentions and hashtags
  • Parent-Child Structure: Each image becomes a child post
  • Interactive Features: Users can react to individual images
RequirementLimitNotes
File SizeUp to 100MB per imagePlatform may have lower limits
Image CountMaximum 10 imagesPer single post
File FormatsJPEG, PNG, WebP, etc.Platform dependent
Images must be uploaded first before creating the post. See Image Handling for upload instructions.
1

Upload Images

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

Create Post

Use the file IDs in your post creation request
3

Handle Response

The post will contain parent and child posts for each image

​
Parameters

ParameterTypeRequiredDescription
textString✅Caption text (max 20,000 characters)
images/imageFilesArray✅Image files or uploaded image data
targetTypeEnum✅Target type (user or community)
targetIdString❌Target ID (null for own feed)
tagsArray<String>❌Tags for categorization
metadataObject❌Custom metadata
func createImagePostExample(images: [AmityImageData], text: String) async {
    // Build your post structure
    let builder = AmityImagePostBuilder()
    builder.setText(text)
    builder.setImages(images)
    // Create a post from the builder
    do {
        let post = try await postRepository.createImagePost(builder, targetId: nil, targetType: .user, metadata: nil, mentionees: nil)
    } catch {
        // Handle error here
    }
}

​
Best Practices

​
Troubleshooting

Parent-Child Structure: When you upload multiple images, the main post becomes the parent, and each image creates a child post that users can individually react to and comment on.

​
Common Use Cases

  • Photo Sharing: Share personal photos and memories
  • Product Showcases: Display products with multiple angles
  • Event Documentation: Share photos from events and gatherings
  • Before/After Comparisons: Show transformations or progress
  • Step-by-Step Guides: Visual tutorials and instructions
  • Gallery Posts: Curated collections of related images

Image Upload

Learn how to upload and manage images before creating posts

Text Posts

Create text-based posts with mentions and hashtags

Video Posts

Share video content and multimedia experiences