Basics
Group Ambassadors is a group management delegation app. It allows Jira administrators to nominate group ambassadors who are able to locally manage groups within Jira, without being given administrative privileges.
Here are a few definitions and some vocabulary as used in this guide:
- Ambassador: an ambassador is a group manager who is not an administrator of Jira.
- Nested groups: Nested groups is a feature offered in some user directories in Jira (e.g. the embedded crowd directory) which allows groups to contains user and groups as members. This is useful for permissions inheritance. (Learn more about Nested Groups.)
- Indirect member(s): indirect membership of groups happens when nested groups are enabled. An indirect member is someone who is not a direct member of a group but inheriting the membership from a subgroup. For instance, if a group called "IT Department" contains many subgroups, one of which being called "DevOps", all members of DevOps will be indirect members of "IT Department".
Browsing your groups
Group Ambassadors allows you to browse the groups you're member of.
In order to check who are the other members of one of your groups, you can click on your profile and choose the "Manage my groups" option:
You will be redirected to the group management module, from which you will be able to choose one of the groups you're member of using the "View" link:
If you are a group Ambassador, you can browse and manage users in the group. The action offered will therefore be "Manage" instead of "View".
The list of all members will be displayed paginated.
Each page will contain 25 users and you can navigate between pages using the links at the bottom of the page: the arrow will take you to either next or previous page where the numbers will take you directly to the corresponding page number.
Admins can define policies for group browsing, therefore, there might be groups you can see but not browse. They will be flagged with a lock icon:
Even if you can't browse a group, if you're an Ambassador, you can still add new members!
Displaying Group Usage
From the group management module you can click on "View group usage" for any group you're member of. That page will display how the group is used in project (i.e. associated with Roles) in the instance:
Managing a group
If you are an Ambassador for the group you're browsing, you will have a few more options: adding and removing users.
Adding a user to the group
You can use the top section of the page to start typing a user name, then use the "Add" button to save and add the user to the group:
Starting with version 1.1, you can add multiple users to the group you're currently managing in a single click
You will receive a notification and the user list will be updated once the user is successfully added:
Removing a group member
You can use the "Remove from group" action to remove a user from a group. A notification will confirm the removal have been done:
Nominating Ambassadors
If Super Ambassadors feature is enabled, you can nominate other Ambassadors for the groups you're Ambassador of.
To do so, simply click on the "Nominate Ambassadors" link in the Group Browser:
A popup will show and you can nominate one or multiple Ambassadors by typing their name, username or email.
Checking who else is Ambassador
As an Ambassador, you can also check who else is Ambassador for a group by clicking on the "?" icon near the group name in the Group Browser:
Audit Logs Notice
Please note that all actions taken by Ambassadors are tracked in Jira's Audit Log.
those actions might also be tracked in Group ambassadors logs.
Jira administrators will be able to follow actions from the log for security reasons.