---
title: pp_create_group
description: "``` /** * Create a new Permission Group * @param array group_vars_arr : * - group_name * - group_description (optional) * - metagroup_type (optional, for internal use) * @return int ID of new group */ function pp_create_group ($group_vars_arr) ``` ##…"
url: "https://publishpress.com/knowledge-base/pp-create-group/"
updated: "2025-05-06"
category: PublishPress Permissions / Developer
---

# pp_create_group

```
/**
 * Create a new Permission Group

 * @param array group_vars_arr :
 *   - group_name
 *   - group_description (optional)
 *   - metagroup_type (optional, for internal use)
 * @return int ID of new group
 */
function pp_create_group ($group_vars_arr)
```

## Example usage

```
$group_id = pp_create_group( 'group_name' => 'Cool Group', 'group_description' => 'Users who are cool' );
```

## Notes

The metagroup_type parameter is used internally (wp_role for auto-created WordPress role groups and rvy_notice for [PublishPress Revisions](https://publishpress.com/links/revisions) Monitor groups). External usage of this parameter is not expected nor currently supported.