> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: wix-groups-backend

## Namespace: groups

## Article: Introduction

## Article Link: https://dev.wix.com/docs/velo/apis/wix-groups-backend/groups/introduction.md

## Article Content:

# Introduction
The Groups API provides functionality for managing groups, including creating, deleting, updating, and querying groups.
 
> **Note:**
> There is a [new version](https://www.wix.com/velo/reference/wix-groups-v2/groups) of this API.
> If you're already using this module in your code,
> it will continue to work.

### Settings for Typical Use Case
+ Site admins determine who can create a group. This setting can be found in your site's Dashboard under **Groups Application > General Settings > Group Creation**.
+ If set to site members with admin approval, site members can create a group using the [`createGroup()`](https://dev.wix.com/docs/velo/apis/wix-groups-backend/groups/create-group.md) function, and the group becomes a `createRequest` with a name of `PENDING`. The site admin either approves or rejects the request to create a group. 
+ If set to all site members, site members can create a group using the `createGroup()` function (no approval required). 
+ If set to only admins, only site admins can create a group using the `createGroup()` function.
+ The default is set to site members with admin approval.
+ **Note:** If the `suppressAuth` option is set to `true`, all permissions are overwritten, and all site members can create a group. 
+ When a group is created, the newly created group is added to the Groups List page of your site.

The Groups API provides functionality allowing you to:
 + [Create](https://dev.wix.com/docs/velo/apis/wix-groups-backend/groups/create-group.md) a new group. 
 + [Delete](https://dev.wix.com/docs/velo/apis/wix-groups-backend/groups/delete-group.md) an existing group. 
 + [Get](https://dev.wix.com/docs/velo/apis/wix-groups-backend/groups/get-group.md) group information by ID. 
 + [Get](https://dev.wix.com/docs/velo/apis/wix-groups-backend/groups/get-group-by-slug.md) group information by slug. 
 + [List](https://dev.wix.com/docs/velo/apis/wix-groups-backend/groups/list-groups.md) all groups.
 + [Query](https://dev.wix.com/docs/velo/apis/wix-groups-backend/groups/query-groups.md) groups. 
 + [Update](https://dev.wix.com/docs/velo/apis/wix-groups-backend/groups/update-group.md) group information.

### Permissions Information
>**Note:** You can override the permissions below by setting the `suppressAuth` option to `true`. 

|Functions|Permissions
|--|---|
| `createGroup()`|Manage in your site's Dashboard
| `deleteGroup()`, `updateGroup()`|Site admin, group admin
| `listGroup()`, `getGroup()`, `queryGroup()`|For public & private groups: any site member <br> For secret groups: group members, site admin


To use the Groups API, import `groups` from the `wix-groups-backend` module:

```javascript
import { groups } from "wix-groups-backend";
```