Skip to main content
Use the create-community API for your platform to set up a community with a display name, description, privacy mode, category IDs, post moderation setting, story settings, metadata, and optional initial members.
Public/private visibility, discoverability, and join approval are separate settings in the SDK. Configure the combination that matches your product flow, then rely on backend permission enforcement for actual access control.

Parameters

TypeScript exposes CommunityRepository.createCommunity(). iOS uses AmityCommunityCreateOptions with createCommunity(with:). Android and Flutter start from AmitySocialClient.newCommunityRepository().createCommunity(...).

Privacy Settings

Post Moderation Options

Story Settings

Communities can be configured with story comment settings:

Create a Community

Use this method after your app has collected the required display name and any optional privacy, moderation, category, member, tag, or metadata settings.
Community tags are shown for TypeScript, Android, and Flutter. The current iOS create/update options do not expose a public community tag setter.

Best Practices

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

  1. Show essential settings first, advanced options later.
  2. Use sensible defaults to reduce decision fatigue.
  3. Allow users to preview community settings before creation.
  4. Guide new community creators through setup.

Performance Optimization

  1. Compress avatar images before upload.
  2. Validate metadata structure client-side.
  3. Handle creation asynchronously with loading states.
  4. Provide clear error messages and retry options.

Update Community

Modify community settings and properties after creation

Community Categories

Organize communities with category management

Community Membership

Handle membership and moderation after community creation

Community Discovery

Make your created communities discoverable to users