> For the complete documentation index, see [llms.txt](https://help.security.gallagher.com/knowledge-hub/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.security.gallagher.com/knowledge-hub/configuration-client/site-management/notifications/assigning-cardholders-to-roles-via-bulk-change.md).

# Assigning Cardholders to Roles via Bulk Change

### Introduction

This procedure describes how to initiate a bulk change of multiple cardholder role relationships in Command Centre. To perform this procedure operators need both the "Bulk Change" and "Edit Cardholders" operator privileges. In addition, operator's need sufficient divisional and other privileges to carry out each individual change listed within a bulk change.

### Procedure

1. Perform Steps 1 - 4 of the [Initiating a new Cardholder Bulk Change](https://help.security.gallagher.com/knowledge-hub/configuration-client/site-management/bulk-changes/initiating-a-new-cardholder-bulk-change.md) procedure and then go to Step 2 of this procedure.

   **Notes:**

   * These steps cover selecting all the cardholders or Access Groups that require changing, and placing them onto the "Select Cardholders or Access Groups" screen of the Cardholder Bulk Changes Wizard.
   * The **Copy all cardholders** feature, which allows a simple change for all cardholders, can be used here. You can copy all cardholders currently reporting to a person in a role, from his/her **Relationships** tab. This is useful when a person in a role leaves and you want to copy the people currently reporting to them to a new person, via a bulk change. See [Copying all cardholders under a Role](https://help.security.gallagher.com/knowledge-hub/configuration-client/site-management/notifications/copying-all-cardholders-under-a-role.md) for the procedure.
2. Click the **Next** button.

   The "Select Changes" screen of the Cardholder Bulk Changes Wizard displays.

   ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-f08fa48f55e2de9088cf0383d231c8f9a93fb24c%2Fchold_bulkchangeroles1.png?alt=media)
3. Click the **Modify Selected Cardholders** radio button, and tick the **Change Relationships** checkbox.
4. Click the **Next** button.

   The "Change Cardholder Relationships" screen of the Cardholder Bulk Changes Wizard displays.

   ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-c377390f1dd85e8c76d2456fbe5f7b5a915680b3%2Fchold_bulkchangeroles2.png?alt=media)

   This screen allows you to select changes to make to the relationships for the cardholders.
5. Click **Manage** from the menu bar, then **Roles**.

   The **Role** List Window opens.
6. Select the Roles that need adding to and/or deleting from the cardholders, and drag and drop them into the appropriate grids on this screen of the Wizard, then close the **Role** List Window.

   ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-17b6708c010e1bb7adb1c483081a66b84d429d31%2Fchold_bulkchangeroles3.png?alt=media)

   **Notes:**

   * In the "Add/Modify Relationships" section of this screen, Roles can be added to the grid using drag-and-drop, and then cardholders can be added using drag-and drop or the Cardholder drop-down list.

     Roles and Cardholder values can be changed using the applicable drop-down list, prior to processing the bulk change.
   * If the Bulk Change action is to 'add' a relationship record to a cardholder for a Role that is already filled, then the result will effectively be a change to the cardholder held against the role.
   * All Roles added to a cardholder, must be accompanied with a populated cardholder filling that role, (i.e. a Role cannot be added that is 'blank').
   * Removing Relationships is achieved using drag-and-drop of the Role into the grid and processing of the Bulk Change, to remove the role and cardholder relationship record from each cardholder selected for the process.
7. Click the **Next** button.
8. Return to the [Initiating a new Cardholder Bulk Change](https://help.security.gallagher.com/knowledge-hub/configuration-client/site-management/bulk-changes/initiating-a-new-cardholder-bulk-change.md) procedure and perform Steps 28 - 31 to complete the bulk change.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.security.gallagher.com/knowledge-hub/configuration-client/site-management/notifications/assigning-cardholders-to-roles-via-bulk-change.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
