Rich Text Support
Up to 20,000 characters with mentions and hashtags
Flexible Targeting
Post to user feeds, communities, or your own timeline
Overview
Text posts provide a clean, straightforward way to share written content:- Text Support: Up to 20,000 characters per post
- Mentions: Tag other users with @displayname syntax
- Hashtags: Categorize content with #hashtag syntax
- Custom Metadata: Add additional structured data
- Flexible Targeting: Post to user feeds or communities
Parameters
Parameter | Type | Required | Description |
---|---|---|---|
text | String | ✅ | Text content (max 20,000 characters) |
targetType | Enum | ✅ | Target type (user or community ) |
targetId | String | ❌ | Target ID (null for own feed) |
tags | Array<String> | ❌ | Tags for categorization and search |
metadata | Object | ❌ | Custom metadata for the post |
mentionUsers | Array<String> | ❌ | User IDs to mention in the post |
Best Practices
Content Guidelines
Content Guidelines
- Keep text concise and engaging
- Use mentions sparingly to avoid spam
- Add relevant hashtags for discoverability
- Include context for better user engagement
Technical Implementation
Technical Implementation
- Validate text length before submission
- Handle network errors gracefully
- Provide user feedback during creation
- Cache drafts for better user experience
User Experience
User Experience
- Show character count indicators
- Provide auto-complete for mentions
- Suggest relevant hashtags
- Allow draft saving and editing
Troubleshooting
Text Length Validation
Text Length Validation
Problem: Post creation fails with text length errorSolution: Ensure text content is under 20,000 characters
Mention Format Issues
Mention Format Issues
Problem: Mentions not working properlySolution: Use correct format with @username (no spaces in username)
Target Validation
Target Validation
Problem: Post fails with invalid target errorSolution: Verify target exists and user has permission to post
Common Use Cases
- Status Updates: Share personal thoughts and experiences
- Community Discussions: Start conversations in community feeds
- Announcements: Broadcast important information
- Questions: Ask for advice or opinions from followers
- Storytelling: Share experiences and narratives
- Links Sharing: Share URLs with context and commentary