Search.../
  1. APIs

deleteGroup( )

Deletes a group.

Description

The deleteGroup() function returns a Promise that resolves to the deleted group after it has successfully been deleted. Only site admins and group admins can delete their group. After the group is deleted, it is removed from both your site and the site's Dashboard.

Note: If the suppressAuth option is set to true, all permissions are overwritten, and all site members (including non-group members) can delete a group.

Syntax

function deleteGroup(groupId: string, [options: Options]): Promise<Group>

deleteGroup Parameters

NAME
TYPE
DESCRIPTION
groupId
string

ID of group to delete.

options
Optional
Options

Authorization options.

Returns

Return Type:

Promise<Group>
NAME
TYPE
DESCRIPTION
_id
string

Group ID.

name
string

Group name.

slug
string

Part of a group's URL, for example, 'https:/example.com/groups/{my-group-slug}'. Generally based on the group name, but for secret groups it is an autogenerated string of characters, for example, 'https:/example.com/groups/{5D3yTX}'. It is case-sensitive.

description
string

Group description.

privacyStatus
string

Group privacy level. One of:

  • PUBLIC: Site visitors can see the group and its content in the list of groups. Site members can join the group.
  • PRIVATE: Site visitors can see the group in the list of groups, but only group members can see its content. Site members can request to join the group.
  • SECRET: Only group members can see the group and its content in the list of groups. Site members can only join if invited by group admins, or other group members.
coverImage
CoverImage

Group cover image.

memberTitle
string

What group members are called. For example, 'Coworkers', 'Friends', or 'Students'.

memberCount
number

Number of members in the group.

settings
GroupSettings

Group settings.

lastActivityDate
Date

Date and time the group was last active. For example, a post or comment.

_createdDate
Date

Date and time the group was created.

_updatedDate
Date

Date and time the group was last updated.

owner
string

Site member ID of the group creator. Defaults to group creator.

Was this helpful?

Delete a group

Copy Code
1import { Permissions, webMethod } from 'wix-web-module';
2import { groups } from 'wix-groups-backend';
3

4// Sample groupId value:
5// 'fc3df3c1-36b2-4279-8be1-8e72a05a88c8'
6//
7// Sample options value:
8// {
9//   suppressAuth: true
10// }
11

12export const myCreateGroupFunction = webMethod(Permissions.Anyone, (groupId, options) => {
13  return groups.deleteGroup(groupId, options)
14    .then((deletedGroup) => {
15      return deletedGroup;
16    })
17    .catch((error) => {
18      console.error(error);
19    });
20});
21

22/* Promise resolves to:
23 * { 
24 *   "_id": "fc3df3c1-36b2-4279-8be1-8e72a05a88c8"
25 *   "name": "My Group 1"
26 *   "slug": "my-group-1"
27 *   "description": "Welcome to the group! You can connect with other members, get updates and share videos."
28 *   "privacyStatus": "PUBLIC"
29 *   "coverImage": {
30 *     "imageUrl": "wix:image://v1/3aa9074e348009011fa9f2d2981a~mv2.jpg/kite.jpg#originWidth=827&originHeight=445",
31 *     "position": {
32 *       "x": 160,
33 *       "y": 13
34 *     }
35 *   }
36 *   "memberTitle": "Members"
37 *   "memberCount": 20
38 *   "settings": {
39 *     "groupUpdatePostEnabled": true
40 *     "membersCanApprove": false
41 *     "membersCanInvite": true
42 *     "showMemberList": true
43 *     "welcomeMemberPostEnabled": true
44 *   }
45 *   "lastActivityDate": "Sun Sep 26 2021 08:23:23 GMT+0300"
46 *   "_createdDate": "Tues January 22 2020 12:56:02 GMT+0300"
47 *   "_updatedDate": "Fri October 2 2021 04:56:22 GMT+0300"
48 *   "owner": "9ne8e9e1-d050-4c86-9684-e7f231600a34"
49 * }
50 */