---
title: "getProjectRoleByUserList"
canonical: "https://support.appfire.com/space/JCLI/70783249/getProjectRoleByUserList"
format: markdown
---
> Macro (aura-html)

See also: [Actions](https://appfire.atlassian.net/wiki/spaces/JCLI/pages/70787366)

> Macro (details)
> 
> | **Description** | Get project roles for a user across projects. By default all projects will be included. This action can take a long time to complete depending on number of projects and roles! Filter projects by lead, category, and regex on project key. Use userId of @all to product a list for all users. Each role defines a column with a Yes or No value that indicates if the user is authorize to the project according to the role. This includes either directly authorized as a user or as a member of a group that is authorized. Use columns to subset the roles you want to display. |
> | --- | --- |
> | **Required Parameters** | [userId](https://appfire.atlassian.net/wiki/spaces/JCLI/pages/70785776) |
> | **Optional Parameters** | [lead](https://appfire.atlassian.net/wiki/spaces/JCLI/pages/70789730), [category](https://appfire.atlassian.net/wiki/spaces/JCLI/pages/70790035), [regex](https://appfire.atlassian.net/wiki/spaces/JCLI/pages/70789814), [outputType](https://appfire.atlassian.net/wiki/spaces/JCLI/pages/70784259), [file](https://appfire.atlassian.net/wiki/spaces/JCLI/pages/70784297), [append](https://appfire.atlassian.net/wiki/spaces/JCLI/pages/70790085), [columns](https://appfire.atlassian.net/wiki/spaces/JCLI/pages/70784781), [select](https://appfire.atlassian.net/wiki/spaces/JCLI/pages/70790299), [options](https://appfire.atlassian.net/wiki/spaces/JCLI/pages/70784233), [encoding](https://appfire.atlassian.net/wiki/spaces/JCLI/pages/70785169) |
> | **Type** | [Get](https://appfire.atlassian.net/wiki/spaces/JCLI/pages/70780909/Action+Types#ActionTypes-Get) |
> | **Category** | [Users](https://appfire.atlassian.net/wiki/spaces/JCLI/pages/70780591/Action+Categories#ActionCategories-Users) |
> | **Output Formats** |  |
> | **Replacement Variables** |  |
> | **Hosting** | cloud,server,datacenter |
> | **Since Version** |  |
> | **Examples** |  |

## Related How To's

> Macro (cql-query)