Delete Community

​

Parameters

​

Permission Requirements

​

Delete a Community

import { CommunityRepository } from '@amityco/ts-sdk';

async function deleteCommunity(communityId: Amity.Community['communityId']): Promise<Amity.Community> {
  const deletedCommunity = await CommunityRepository.deleteCommunity(communityId);

  return deletedCommunity;
}

try await communityRepository.deleteCommunity(withId: "community-id")

fun deleteCommunity() {
    AmitySocialClient.newCommunityRepository()
        .deleteCommunity(communityId = "communityId")
        .doOnComplete {
            // Community deleted.
        }
        .doOnError { error ->
            // Handle error.
        }
        .subscribe()
}

void deleteCommunity(String communityId) {
  AmitySocialClient.newCommunityRepository()
      .deleteCommunity(communityId)
      .then((value) {
        // Community deleted.
      })
      .onError((error, stackTrace) {
        // Handle error.
      });
}

​

Client Impact

• Remove the community from any local list or cached UI state.
• Navigate away from deleted community detail screens.
• Stop showing actions that require the deleted communityId.
• Refresh affected discovery or membership queries when needed.

​

Pre-deletion Considerations

​

Product Policy

1. What data is retained or recoverable outside the client SDK.
2. Whether members should be notified before deletion.
3. Whether archive, privacy, or moderation actions are safer than deletion.

​

Member Management

​

Best Practices

​

Implementation Guidelines

1. Require multiple explicit confirmations.
2. Make users type the community name to confirm.
3. Verify user permissions before showing delete options.
4. Show clear progress during deletion operations.
5. Provide clear confirmation of successful deletion.

​

User Experience Considerations

1. Emphasize the permanent nature of deletion.
2. Offer data export before deletion if your product supports it.
3. Provide tools to notify community members.
4. Handle post-deletion navigation appropriately.

​

Related Topics