Skip to main content

XR Groups, Roles and Mandates

Read this guide to learn how to use the Hub to manage your group's mandates, roles, members, etc.

XR Groups Screen

If you click 'My Groups' on the Home page, you will see a screen like this:

Choose a group to see all its details in context.

This is the Group Admin view – ordinary users can see this screen, but won’t have the links to change things.

If you want to become a Group Admin for a group in order to be able to edit here, you will need to contact your Internal Coordinator (IC) / External Coordinator (EC) or an existing Group Admin who is listed for your group. If all these people have stepped back, then contact your parent group Hub Admin.

This page shows the group in context. You can click on any of the group names (in the bar above the group name in bold, or in the diagram of the organism on the right) to see its parent and children groups. You can click on the dropdowns (in the grey boxes) to see more information.

Each group is displayed the same way. Public links are always clickable. If you are a member of the group, the private links are clickable too. If you are a Group Admin, the extra admin links also appear.

The organism graphic display shows the group in context – you can click the full screen icon (the black 4 x corners making a square, top right) to make it bigger.
You can click on groups within this view to shift your view to display a different group. To come back out from that group and back into the bigger framework of groups, use the spyglass icon, top left.



To find your way about XRUK, you can click on any group name on the screen to show that group, with its parent and children groups. Alternatively, you can click on a group in the Hub Circles XR Organism graphic display at the top right of the image above. This has a full screen button (the 4 x corners making a square, top right) to make it larger and easier to navigate.

If you are using the Hub Circles display, you can click the Filter link text below the graphic (in green font). This will hide some of the detail, to make the diagram less busy. If you set a filter, it is remembered, and used every time you open this view.

Here is an illustration of what the filter function brings up for someone looking at the Cymru Circle:


Don't be afraid of playing around with your options to filter here! Just remember that the filter stays in place for any future visit to this screen, so you might want to revert back to the full picture, with no filters before leaving the page!

XR Organism

To describe our XR UK organisational structure, we are on: This is a public site which is updated from the Hub every night.

How To Find a Person to Contact Them on Mattermost

In the group they are a member of, click the grey 'Roles' band to open up a drop down of further detail. If you click the name of someone you wish to contact, you will automatically have a new tab opened that will take you to a direct messaging thread with that person on Mattermost.

How to Change People's Roles in your Group

All roles all have a 'shelf-life', called a tenure, i.e. they have a pre-arranged end date, agreed with the person stepping into a role. Having an end or review date will allow for new people to step forward to take on responsibilities and allow for life-changes for those in the role. This helps to mitigate for power. When someone's role reaches its end point, the group should elect a replacement (can be the same person, if they are willing), and you should update the role holders on the Hub.

The 'Roles' dropdown (in the grey boxes) lets you view/edit the Roles within your group. Alternatively, you can click on an individual role in the display to edit it. See Edit Role screen below. The Roles dropdown view will show who is in the Core Roles and any sub-groups of that circle.

How to Change Your Group's Mandate

The 'Mandate' dropdown (in the grey boxes) will show the group's Mandate. If you are Group Admin of the parent group, you will see an edit pencil button that will let you change the mandate.

To edit the Mandate:

  • First ensure the parent circle has agreed the changes
  • Select Mandate dropdown
  • Click the edit pencil
  • Make changes
  • Save

The XR UK constitution says that all working groups should have a Mandate. However, not all parts of XR UK are covered by the constitution. Some Hub Groups were created without one. To make it clear when a group does not have to follow the constitution, we use different names:

If the group follows the constitution If it doesn't
Mandate Scope
Role Position
Purpose What this group is for
Accountability Activity
Domain Resource

(for more details see SOS Facilities on the Hub)

The Mandate/Scope sections include:

  • Purpose/What this group is for
  • Accountabilities/Activities
  • Domains/Resources
  • Policies (optional section)

As a guide to completing the Mandate, you might research those of similar Groups in your region, or UK wide (Working Groups and Circles). Such existing Mandates may assist with arriving at your own wording.

See Rebel Toolkit guidance here: Mandates and How to Write Them.

How to See Changes Made to Roles, Members, Mandates

How to See People In My Group

The 'Members' dropdown (in the grey drop down boxes) shows you a list of everyone in the group. Here you can set their roles, make them Group Admins or turn Group Admin status off. From there, you can click 'All Roles' to see all the roles that person has. From here you can click 'Step Back From Roles' to pass those roles on to someone else.

If you remove someone from one or more roles which are linked to another group, and that is the only role they hold in that group, you will see another screen where you can confirm whether or not they should also be removed from the other group.

An example of this might be an External Coordinator (EC) who is in a 'link role' to the Parent Circle. There may also be a link role from one group to another, e.g. Facilitation has a link role to XR UK Talks and Training.

How to Change My Role

'Edit My Role' in the Admin section lets you edit your own role in the group. Everyone in your group can view their own role, or step back from their role, only Group Admins can assign people to roles.

For more about core roles see the XR UK constitution.

Edit Role Screen

When a new group is created on the Hub, it gets a set of 3 standard roles:

  • Internal Coordinator
  • External Coordinator
  • Group Admin.

There are an additional 8 roles, suggested by the Self Organising Systems Circle, which may be selected by the Group Admin when adding new Roles to the original set.

To add a new role for your group, click the  'Add Role' icon, then insert the role name you require.

As you type, you are offered any Default Roles which match the input text; if you then select a Default Role, the form is prefilled with the details (including mandate) of that role - which can then be edited, if necessary.

This is just to save typing, and will help any Group Admin who may not know the exact wording of the Mandate for the desired Default Role. Note that any other new Role will have a blank Mandate - i.e. Purpose and Accountabilities - which may be completed at a later time.

Ticking Core Role shows the role in blue instead of green in the diagram. Normally, only Internal Coordinator, External Coordinator and Group Admin are Core Roles.

The Private setting is the default for the role. If this is ticked, then users will have Private ticked by default. This can be changed by you or them.

Selecting a permission from the Requires Group Permission dropdown means that people assigned to this role automatically get that permission for this group, so they can invite people (Inviter), or edit roles, channels, forums, etc. (Group Admin).

You can add Accountabilities, or drag them using the handle to reorder them, or delete them with the red x button.

You can add Domains or delete them with the red x button.

Setting/Changing a Role Holder

You can place users in their role by selecting their names from the drop-down 'Login' list. With admin permissions, you may also remove them by clicking the red ‘X’ next to their name. The 'Private' setting by each user should be ticked if the user does not want anyone outside the group to see that they hold this role.

You can set an 'Until' date for each person assigned to a role. This is the date their holding of that role will be reviewed. This allows people assigned to a role for a limited time to be confident that they won’t be left holding that role forever. Roles where the 'Until' date has passed will show in red on the group diagram.

Linking a Role to Another Group

The only limitation on editing information in this regard is that you have to be a Group Admin of both groups, i.e.: parent and child.

Then either select an existing role in that group from the Linked Role dropdown, or type in a new role name if the new role will be created in the other group.

Normally a Group Admin of one group will create a child group, which automatically makes them Group Admin of the child group. They will then link the External Coordinator role in the child group to the parent group. They may well also appoint other Group Admins of the child group, then may remove themselves from the child group when this has been done. So just because they set up this administrative work does not mean to say they will continue in administering that group; they may hand to new Admins.

If nobody is Group Admin of both groups, Coordinators or Group Admins of both groups will have to ask a Hub Admin to do this task for you. If you don't know a Hub Admin, ask in Hub Help Desk on Mattermost.

If you remove people from a role which is linked to another group, and that is the only role they hold in that group, you will see another screen where you can confirm whether or not they should also be removed from the other group.

What Happens When a Role Allows Access to More Than One Hub Group?

When someone does one of the following things:

  • Edits the Auto Join Roles screen (Hub Admins only)
  • Edits the people in a role
  • Edits the roles a person is in (+)
  • Deletes a role
  • Steps a person back from a role (+)
  • Creates a group
  • Deletes a group
  • Admin edits a group (Hub Admins only)
  • Removes someone from a group (+)

The change could entitle some people to be in different Hub Groups, e.g. if they join or leave a linked role, or a role with a support group.

The joining or inviting happen automatically, but any groups they should probably be removed from are first listed in a screen with tickboxes against each one, so the person making the change has a chance to untick people they do not want to be removed.

This removal screen is simpler in the cases with a + above, because only a single person is affected, so it just shows a list of groups the person could be removed from. In the other cases (without the +), it may have to show more than 1 person being removed from each group. In the example screen, both Albert Reid and Nathan Powell are candidates to be removed from both groups.

Here is the simple screen:

Here's the more complicated screen:

Please click 'Save' in this screen to carry out the removals. If you think a person should not be removed, first untick the corresponding 'Confirm' box.

Step Back From Roles Screen

You reach this screen by finding a person with a role in 'All Members', clicking on 'All Roles', then clicking on 'Step Back From Roles'.

If you choose a replacement user from the dropdown, that person will be assigned to all the roles with 'Step Back' ticked (being joined to the organisation if they are not already in it).

If you check Remove From Role, the original person will be removed from the roles with 'Step Back' ticked.

If you check 'Remove From Group', the original person will be removed from all groups with 'Step Back' ticked.

If you remove someone from one or more roles which are linked to another group and that is the only role they hold in that group, you will see another screen where you can confirm whether or not they should also be removed from the other group.

So, for example:

Change Required                   Action                                                                                                                                                    
Add a new person into the role, to be trained by the original person                   Select the new person in 'Replacement User'. Leave 'Remove From' boxes unticked. Tick all the roles you want the new person to be added to and untick the others.                                                                                                                                                      
Pass the role on to someone else because the original role holder has already stepped back. Select new person in 'Replacement User'. Tick 'Remove From Role'. Tick all the roles they are stepping back from and untick the others. If the person has left the group(s) altogether, rather than just stepped back from the role to become an ordinary member, also tick 'Remove From Group'.
Step someone back from their role, without appointing anyone else               Leave 'Replacement User' blank. Tick 'Remove From Role'. Tick all the roles they are stepping back from and untick the others. If the person has left the group(s) altogether, rather than just stepped back from the role to become an ordinary member, also tick Remove From Group.