Posts are the foundation of content creation and sharing in social.plus. A post can include text, images, videos, files, polls, live streams, or custom content—enabling users to express themselves, share information, and connect with others in a network or community.
Posts support real-time events and Live Object features. See Live Objects/Collections and Realtime Events for more.

Post Structure

Posts use a parent-child relationship:
  • The parent post acts as a container (e.g., for text or metadata)
  • Each image, video, or file is a separate child post
  • Both parent and child posts support reactions and comments
Example: An image post with three images will have one parent post (text container) and three child posts (each with an image).
Users can interact (react, comment) with both parent and child posts, enabling rich engagement.

Post Data Model

NameData TypeDescription
postIdStringID of the post
parentPostIdStringID of the parent post (null if parent)
postedUserIdStringID of the user who posted
targetIDStringID of the target (e.g., community, user)
targetTypeStringType of target (e.g., community, user)
dataTypeStringData type of post (text, image, video, etc.)
dataObjectData of the post
metadataObjectMetadata of the post
flagCountIntegerNumber of times the post is flagged
editedAtDateDate/time the post was edited
createdAtDateDate/time the post was created
updatedAtDateDate/time the post was updated
reactionsObjectInformation about the post reactions
reactionsCountIntegerNumber of reactions to the post
myReactionsArray of stringsReactions by the current user
commentsCountIntegerNumber of comments to the post
commentsArray of AmityCommentThe first three comments for previewing
childrenPostsObjectChild posts (e.g., images, videos)
isDeletedBooleanTrue if the post is deleted
hasFlaggedCommentBooleanTrue if the post has flagged comments
hasFlaggedChildrenBooleanTrue if the post has flagged children
tagsArray of stringsArbitrary tags for querying/filtering posts
feedIdStringID of the post’s feed

Quick Start Guide

1

Choose Post Type

Select the appropriate post type based on your content:
  • Text: For discussions and announcements
  • Image: For photo sharing and visual content
  • Video: For video content and tutorials
  • Poll: For community engagement and feedback
  • File: For document sharing
  • Live Stream: For real-time broadcasts
  • Custom: For advanced or app-specific content
2

Create Content

Use the creation guides for your chosen post type:
// Example: Creating a text post
const post = await PostRepository.createPost({
  type: 'text',
  data: {
  text: 'hello!',
  },
  targetType: 'community',
  targetId: 'community-id'
});
3

Manage Post

Use management tools to edit, delete, or moderate your posts
4

Track Performance

Monitor engagement through analytics and impression tracking