ONYX
Docs

Communities

Use spaces, channels, roles, invites, and messages.

Communities are structured communication spaces inside Onyx Chat.

A community can include:

  • channels
  • group discussions
  • announcements
  • member roles
  • moderation controls
  • invites
  • shared media
  • community notifications

Communities are designed for organized communication instead of large unstructured group chats.

Depending on the community type, a space can support:

  • private membership
  • public discovery
  • invite-only access
  • moderated posting
  • broadcast channels
  • role-based permissions

Communities

Community access panel

Choose a role to see channel access, posting, invites, moderation, and announcements.

Member

Available action

Post

Allowed

Available action

Reply

Allowed

Available action

React

Allowed

Available action

Mute channels

Allowed

Community Structure

Every community includes:

  • a community identity
  • member access rules
  • one or more channels
  • role and moderation settings
  • notification behavior

A community can contain:

  • discussion channels
  • announcement channels
  • topic channels
  • restricted channels
  • role-specific channels

Some communities may also support:

  • temporary event channels
  • hybrid discussion/broadcast channels
  • linked service channels
  • community-only media access

Channels

Channels organize communication inside a community.

Channel types can include:

  • discussion channels
  • announcement channels
  • broadcast-only channels
  • restricted channels

Discussion channels support:

  • messages
  • replies
  • media
  • reactions
  • pinned items

Broadcast channels may limit posting to:

  • owners
  • moderators
  • approved accounts
  • service accounts

Some channels can appear read-only depending on your role or membership state.

Membership

Community membership controls access to channels and actions inside the space.

Membership can appear as:

  • active
  • invited
  • pending approval
  • restricted
  • removed
  • banned

Access state can appear as:

  • active
  • pending review
  • pending recheck
  • revoked
  • expired

If your membership changes, available actions inside the community can also change.

Some communities may require:

  • invitation approval
  • trust state requirements
  • verification
  • role assignment
  • payment-linked access
  • connected app eligibility

Roles And Permissions

Roles determine what you can do inside a community.

Roles can include:

  • owner
  • admin
  • moderator
  • member
  • restricted member
  • guest

Depending on your role, you may be able to:

  • post messages
  • create channels
  • invite members
  • pin content
  • moderate conversations
  • remove members
  • manage permissions
  • manage announcements

Some moderation actions can remain unavailable until trust or verification requirements are met.

Invites And Joining

Communities can support:

  • invite links
  • invite codes
  • approval requests
  • trusted-member invites
  • restricted enrollment
  • role-gated access

Joining behavior can vary depending on:

  • community settings
  • trust state
  • verification state
  • invite source
  • moderation policy

If access is blocked, the app should explain:

  • why the join failed
  • whether approval is required
  • whether verification is required
  • whether the invite expired

Messages And Discussions

Community conversations support:

  • text messages
  • media
  • files
  • voice memos
  • replies
  • pinned content
  • announcement posts
  • promoted messages where enabled

Message state can appear as:

  • pending
  • sent
  • delivered
  • read
  • failed

Some community actions can depend on:

  • channel permissions
  • moderation restrictions
  • route availability
  • trust state
  • media policy

Large communities can apply:

  • posting restrictions
  • slow mode
  • moderated approval
  • attachment limits
  • invite limits

Notifications

Community notifications can be:

  • real time
  • batched
  • muted
  • mentions only
  • announcement priority
  • digest-based

Large communities are designed to reduce notification overload through:

  • muted defaults
  • mention prioritization
  • batched delivery
  • announcement separation

Notification behavior can vary depending on:

  • your role
  • channel type
  • moderation settings
  • device permissions

Moderation And Safety

Communities support moderation and trust controls inside Onyx Chat.

Moderation features can include:

  • message removal
  • member restriction
  • blocking
  • reports
  • invite restrictions
  • role management
  • posting controls

Some moderation actions may depend on:

  • trust state
  • role permissions
  • community policy
  • verification state

Community moderation is designed to reduce spam, impersonation, and abuse without turning communities into uncontrolled public feeds.

Identity And Communities

Communities are connected to Onyx ID.

Your profile, trust state, and permissions can affect:

  • community visibility
  • posting access
  • moderation eligibility
  • invite permissions
  • trusted member status

Different communities can receive different profile visibility depending on:

  • role
  • relationship context
  • permission scope
  • community rules

Delivery And Availability

Communities are built on the same thread-centered communication model used throughout Onyx Chat.

Community conversations can include:

  • encrypted native messaging
  • delivery status
  • attachment handling
  • message delivery tracking
  • presence state
  • notification state
  • media references

Onyx-native community messaging is encrypted by default.

What Can Affect Availability

Community features can vary depending on:

  • region
  • trust state
  • moderation settings
  • community permissions
  • account verification
  • delivery availability
  • connected app restrictions

Some channels or actions may remain unavailable if:

  • your role changes
  • access expires
  • moderation restricts the action
  • verification is required
  • the community disables the feature

The app should show unavailable actions before you attempt them.