Rich Media Content
Support for images up to 1GB and videos up to 2GB with flexible display modes
Interactive Elements
Add hyperlinks with custom text for seamless user navigation and engagement
Real-time Analytics
Track views, reach, click-through rates, and comprehensive engagement metrics
Stories support ephemeral content with configurable expiry periods, interactive hyperlinks with URL validation, and comprehensive analytics including views, reach, and click-through rates.
Story Content Types
Stories support diverse content formats designed for time-sensitive sharing and immediate engagement.| Content Type | Max Size | Duration | Use Cases |
|---|---|---|---|
| Image Stories | 1GB | Network configurable | Product showcases, announcements, visual updates |
| Video Stories | 2GB | 90 seconds max | Tutorials, behind-the-scenes content, live moments |
Key Features
Story Creation
Create image and video stories with interactive elements, metadata, and community targeting.
Story Retrieval
Query active stories, story targets, and global story feeds with real-time updates.
Analytics & Tracking
Track impressions, reach, click-through rates, and user engagement with detailed analytics.
Interactive Features
Add hyperlinks, track link clicks, and create engaging interactive story experiences.
Content Management
Soft and hard deletion, content moderation, and lifecycle management capabilities.
Real-time Updates
Live objects and collections for instant story synchronization and state updates.
Story Properties
Understanding story data structure helps in building robust story experiences.| Property | Type | Description |
|---|---|---|
storyId | String | Unique identifier for the story |
targetType | Enum | Type of target (currently COMMUNITY) |
targetId | String | ID of the target community |
dataType | Enum | Content type (IMAGE or VIDEO) |
data | Object | Story content based on dataType |
storyItems | Array | Interactive elements like hyperlinks |
metadata | Object | Custom properties and additional data |
syncState | Enum | Synchronization status (FAILED, SYNCING, SYNCED) |
isDeleted | Boolean | Deletion status flag |
isSeen | Boolean | User view status indicator |
reach | Integer | Unique user views |
impression | Integer | Total view count |
reactionsCount | Integer | Total reaction count |
expiresAt | DateTime | Story expiration timestamp |
createdAt | DateTime | Story creation timestamp |
Permissions and Limits
Required Permissions
MANAGE_COMMUNITY_STORY: Essential permission for story creation within communities- Default Roles: Moderator, Community Moderator, Super Moderator, Global Admin
Content Constraints
- Community Limit: Up to 100 active stories per public community
- Image Files: Maximum 1GB per story
- Video Files: Maximum 2GB per story
- Video Duration: 90-second maximum (configurable at network level)
When a community reaches its 100 active story limit, new story creation will fail until existing stories expire or are deleted.