---
title: ppc_get_roles()
description: "``` /** * Retrieve supplemental roles for a user or group * @param string agent_type * @param int agent_id * @param array args : * - post_types (default true) * - taxonomies (default true) * - force_refresh (default false) *…"
url: "https://publishpress.com/knowledge-base/ppc-get-roles/"
updated: "2025-05-06"
category: PublishPress Permissions / Developer
---

# ppc_get_roles()

```
/**
 * Retrieve supplemental roles for a user or group

 * @param string agent_type
 * @param int agent_id
 * @param array args :
 *   - post_types (default true)
 *   - taxonomies (default true)
 *   - force_refresh (default false)
 * @return array : $roles[role_name] = role_assignment_id
 */
function ppc_get_roles( $agent_type, $agent_id, $args = array() )
```

## Example usage

```
$group = pp_get_group_by_name( 'Cool Group', 'pp_group' );

$roles = ppc_get_roles( 'pp_group', $group->ID );
$group_role_names = array_keys( $roles );
```

## Notes

- Calling this function for a user returns only roles assigned directly to the user (not roles assigned to the user's groups).
- If you are retrieving roles for the currently logged user using non-default $args, it may also be necessary to include force_refresh => true in the $args array.
- You may pass an array of post_types or taxonomies to limit the returned roles to corresponding types.