Privacy Controls
Create public or private communities with configurable access
Content Moderation
Set up post and story moderation workflows
Custom Metadata
Add custom fields and properties for specialized communities
Media & Categories
Configure avatars, categories, and visual community branding
Communities can be created as public (discoverable by all) or private (invitation-only) with configurable post settings for content moderation, story interaction controls, and custom metadata to support specialized community features.
Create Community
ThecreateCommunity()
method establishes a new community with comprehensive customization options for privacy, content moderation, and branding. Create communities that perfectly match your app’s requirements and user engagement goals.
Parameters
Parameter | Type | Required | Description |
---|---|---|---|
displayName | String | Yes | Public display name visible to all users who can access the community |
description | String | No | Community description explaining purpose and focus |
isPublic | Boolean | No | Community visibility: true for public, false for private (default: true ) |
avatar | Image | No | Community avatar image for visual branding |
categoryIds | Array | No | List of category IDs for community organization |
postSettings | Enum | No | Content moderation settings for posts |
storySettings | Object | No | Story interaction and moderation configuration |
metadata | Object | No | Custom fields and properties for specialized features |
Privacy Settings
Setting | Description | Discovery | Join Behavior |
---|---|---|---|
Public Community | Discoverable by all users | Visible in search and browse | Can join immediately or require approval |
Private Community | Invitation-only access | Hidden from public discovery | Requires invitation or approval |
Post Moderation Options
Option | Description | Use Case |
---|---|---|
ANYONE_CAN_POST | All members can post freely | Open communities with high trust |
ADMIN_REVIEW_POST_REQUIRED | Posts require moderator approval | Controlled content communities |
ONLY_ADMIN_CAN_POST | Only moderators can create posts | Announcement-only communities |
Story Settings Options
Communities can be configured with specific story interaction settings to control user engagement and moderation:Setting | Type | Description | Default |
---|---|---|---|
allowComment | Boolean | Enable/disable comments on community stories | true |
Best Practices
Community Setup: Start with basic settings and allow community owners to customize moderation and features after creation to avoid overwhelming the initial creation flow.
Creation Flow Guidelines
- Progressive Disclosure: Show essential settings first, advanced options later
- Default Values: Use sensible defaults to reduce decision fatigue
- Preview Mode: Allow users to preview community settings before creation
- Onboarding: Guide new community creators through setup process
Performance Optimization
- Image Optimization: Compress avatar images before upload
- Metadata Validation: Validate metadata structure client-side
- Async Creation: Handle creation asynchronously with loading states
- Error Recovery: Provide clear error messages and retry options