import Global from '../../_global.mdx';
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

# viva engage community list

Lists all Viva Engage communities

## Usage

```sh
m365 viva engage community list [options]
```

## Options

<Global />

## Permissions

<Tabs>
  <TabItem value="Delegated">

  | Resource        | Permissions        |
  |-----------------|--------------------|
  | Microsoft Graph | Community.Read.All |

  </TabItem>
  <TabItem value="Application">

  | Resource        | Permissions        |
  |-----------------|--------------------|
  | Microsoft Graph | Community.Read.All |

  </TabItem>
</Tabs>

## Examples

Lists all Viva Engage communities

```sh
m365 viva engage community list
```

## Response

<Tabs>
  <TabItem value="JSON">

  ```json
  [
    {
      "id": "eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiI0NzY5MTM1ODIwOSJ9",
      "displayName": "All Company",
      "description": "This is the default group for everyone in the network",
      "privacy": "public",
      "groupId": "7c99afd7-9f3a-49e2-b105-4ee36314350c"
    }
  ]
  ```

  </TabItem>
  <TabItem value="Text">

  ```text
  id                                                displayName  privacy
  ------------------------------------------------  -----------  -------
  eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiI0NzY5MTM1ODIwOSJ9  All Company  public
  ```

  </TabItem>
  <TabItem value="CSV">

  ```csv
  id,displayName,description,privacy,groupId
  eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiI0NzY5MTM1ODIwOSJ9,All Company,This is the default group for everyone in the network,public,7c99afd7-9f3a-49e2-b105-4ee36314350c
  ```

  </TabItem>
  <TabItem value="Markdown">

  ```md
  # viva engage community list

  Date: 8/29/2024

  ## All Company (eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiI0NzY5MTM1ODIwOSJ9)

  Property | Value
  ---------|-------
  id | eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiI0NzY5MTM1ODIwOSJ9
  displayName | All Company
  description | This is the default group for everyone in the network
  privacy | public
  groupId | 7c99afd7-9f3a-49e2-b105-4ee36314350c
  ```
  
  </TabItem>
</Tabs>
