> 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/bulk-changes/initiating-a-new-cardholder-bulk-change.md).

# Initiating a new Cardholder Bulk Change

### Introduction

This procedure describes how to initiate a new cardholder bulk change in Command Centre. To perform this procedure operator's 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. Click **Manage** from the menu bar, then **Bulk Changes**.

   The **Bulk Changes** List Window opens (in [grid view](https://help.security.gallagher.com/knowledge-hub/configuration-client/introduction-to-command-centre/knowing-your-way-around/list-windows/grid-view.md)).
2. **Right click** and select **New\...Cardholder Bulk Change**.

   The "Select Cardholders or Access Groups" 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-8a58d931e3dc833d526f9915a922e193093ed61e%2Fcholdbc_wizard2.png?alt=media)

   All the cardholders or Access Groups that require changing need to be placed onto this screen, by dragging and dropping them from either the **Cardholder** List Window or **Access Group** List Window as appropriate, or the Find Tool can be used. In this procedure the **Cardholder** List Window has been used.

   **Notes:**

   * Individual cardholders can be selected, or an Access Group can be selected if all the cardholders belonging to the group require changing.
   * If a division bulk change is created, and an Access Group is dragged in to be changed, only the division of the Access Group will be changed.

     To change the cardholders in the division, either drag the Access Group into a cardholder bulk change and change the division, or drag the cardholders individually into the division change.
3. Click **Manage** from the menu bar, then **Cardholders**.

   The **Cardholder** List Window opens.

   Select those cardholders that need changing, and drag and drop them into this screen of the Wizard.

   ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-166edb182525c416f114c7c7dca1ba295d06d383%2Fchintocholdbc.png?alt=media)
4. Close the **Cardholder** List Window.
5. 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)
6. Click the radio button for the option you require, (i.e. either **Delete Selected Cardholders** or **Modify Selected Cardholders** ). Only one of these options can be selected.
7. If **Modify Selected Cardholders** is selected, tick the checkboxes for the items you want to change.

   One or more of these options can be selected.

   **Note:** If your site is licensed for both Visitor Management and Notifications, a **Change Visitor Management Notifications** checkbox will also be available.

   The screen that displays next depends on what selections you made on the "Select Changes" screen.

   <table><thead><tr><th width="300">If you clicked the...</th><th>then...</th></tr></thead><tbody><tr><td><strong>Delete Selected Cardholders</strong> radio button</td><td>click the <strong>Next</strong> button, and go to Step 31.</td></tr><tr><td><strong>Modify Selected Cardholders</strong> radio button</td><td>go to Step 8.</td></tr></tbody></table>
8. Click the **Next** button.

   Individual screens will display for each of the items you ticked for changing.

   **Note:** If you ticked the **Change Competencies** checkbox, see [Competency Bulk Changes](https://help.security.gallagher.com/knowledge-hub/configuration-client/licensable-features/cardholder-competencies/competency-bulk-changes.md) for further details.

   If you ticked the Change Relationships checkbox, see [Assigning Cardholders to Roles via Bulk Change](https://help.security.gallagher.com/knowledge-hub/configuration-client/site-management/notifications/assigning-cardholders-to-roles-via-bulk-change.md) for further details.
9. The "Change Personal Data" screen will only display if the **Change Personal Data Fields** checkbox was ticked on the "Select Changes" screen. If not, go to Step 14.

   This screen allows you to select changes to make to the authorised state and personal data of each cardholder.

   ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-59391126b6bc348562e8609d32d004e2abc9e490%2Fcholdbc_wizard4.png?alt=media)
10. If you want to make personal data changes, select the Personal Data Field (PDF) from the drop-down list.

    The other options in the Personal Data Field section of this screen become enabled.

    **Notes:**

    * This Personal Data Field is the target PDF.
    * Image PDFs and unique PDFs cannot be changed in a bulk change, therefore these PDF types will not appear in the drop-down list.
    * If the PDF is an "Email" or "Mobile" type PDF, then an **Update notification** checkbox becomes available, along with a **Use this personal data field for notification** checkbox.

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

      These checkboxes can be selected in conjunction with any of the radio buttons in the **Update value** section above, with the exception of the **Remove** radio button.
11. Click the radio button for the type of change you want to make.

    <table><thead><tr><th width="210">Radio Button/Field</th><th>Description</th></tr></thead><tbody><tr><td>Search and replace</td><td>When clicked, the <strong>Search for</strong> and <strong>New value</strong> fields are enabled allowing you to replace a selected value with a new one.</td></tr><tr><td>Replace by new value</td><td>When clicked, the <strong>New value</strong> field is enabled allowing you to replace a value.</td></tr><tr><td>Copy values from</td><td>When clicked, the <strong>Personal data field</strong> drop-down list beside it is enabled allowing you to replace the target PDF data with the data existing in the source PDF.</td></tr><tr><td>Append</td><td>When clicked, the <strong>New value</strong> field is enabled allowing you to append a new value to existing data.<br><br><strong>Note:</strong> If the Personal Data Field selected is a "Numeric", "Text - list" or "Date" PDF, this field will not be enabled as it is not possible to append these types of PDFs.</td></tr><tr><td>Remove</td><td>When clicked, no additional fields are enabled, but this allows you to remove data.<br><br><strong>Note:</strong> If the PDF is required to have data in it, (i.e. it is mandatory), the <strong>Remove</strong> option will not be available.</td></tr><tr><td>Search for</td><td><p>The text to be searched for is entered (limited to 200 characters), and replaced with what is entered in the <strong>New value</strong> field wherever it is found in the PDF of the selected cardholders.<br><br><strong>Notes:</strong></p><ul><li>If the Personal Data Field selected is a "Text - list" PDF, the <strong>Search for</strong> field becomes a drop-down list containing the optional text strings available.</li><li>For "Date" PDFs the <strong>Search for</strong> field changes to a Date/Time control and a checkbox is included to represent 'no value', but only for non required PDFs.</li></ul></td></tr><tr><td>New value</td><td><p>Enter new value for PDF (limited to 200 characters). This is checked to make sure it contains valid data.<br><br><strong>Notes:</strong></p><ul><li>If the Personal Data Field selected is a "Text - list" PDF, the <strong>New value</strong> field becomes a drop-down list containing the optional text strings available.</li><li>For "Date" PDFs the <strong>New value</strong> field changes to a Date/Time control and a checkbox is included to represent 'no value', but only for non required PDFs.</li></ul></td></tr><tr><td>Personal data field (source)</td><td>This is the source PDF. When selecting the <strong>Copy values from</strong> option, the data in this source PDF will be "copied" to the target PDF.<br><br><strong>Note:</strong> The source PDF must be of the same data type as the target PDF. However "Text", "Text-List", "Email", "Mobile", "Address" and "Phone" type PDFs can be used interchangeably since the underlying type is "Text" for all of these.</td></tr></tbody></table>
12. If you want to make changes to the authorised state of each cardholder tick the **Change Cardholder Authorised** checkbox.

    The radio buttons in that section become enabled.
13. Click the radio button for the state you require, (i.e. **Authorised** enables a card for use and **Unauthorised** disables a card), and click the **Next** button.
14. The "Change Card Details" screen will only display if the **Change Card Details** checkbox was ticked on the "Select Changes" screen. If not, go to Step 18.

    This screen allows you to select changes to make to the Card Type.

    ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-d55c7329bccde45816a32222535cb2e893f8f5dc%2Fcholdbc_wizard5.png?alt=media)
15. Select the Card Type from the drop-down list.

    The fields on this screen become enabled.
16. Do you want to remove or modify the selected card type for cardholders?

    <table><thead><tr><th width="162">If...</th><th>then...</th></tr></thead><tbody><tr><td>remove,</td><td>click the <strong>Remove Card</strong> radio button and go to Step 18.</td></tr><tr><td>modify,</td><td>click the <strong>Modify Card</strong> button.</td></tr></tbody></table>
17. Configure the changes you want to make as necessary, and click the **Next** button.

    One or more of these options can be selected.

    <table><thead><tr><th width="162">Checkbox</th><th>Description</th></tr></thead><tbody><tr><td>Increment Issue Level</td><td>Tick if the selected cardholders require bulk incrementation of card issue level.</td></tr><tr><td>Enable/Disable Card</td><td>Choose to either enable or disable the card by ticking the appropriate checkbox.</td></tr><tr><td>Change Card Type</td><td><p>Tick if the card type of the card for the selected cardholders requires changing. When ticked, the drop-down field is enabled allowing you to select a different card type.<br><br><strong>Notes:</strong></p><ul><li>Only card types with the same Card Number Formats can be exchanged.</li><li>Only those card types that you have view privileges for will appear in the drop-down list.</li><li>If a cardholder has more than one card of a Card Type, they will all be changed unless one card fails to update. When a card fails to update, no cards for that particular cardholder will be updated.</li><li>Only cards in a non-customised card state at the time the bulk change is run will be able to change card type, (i.e. cards in any state including Lost, Stolen and Damaged can be changed, but not cards in a card state that is added manually by an operator.</li></ul></td></tr><tr><td>Change Activation Date</td><td>Tick if the access start date needs to be changed. When ticked, the date and time fields are enabled allowing you to select a new activation date.</td></tr><tr><td>Change Expiry Date</td><td>Tick if the access end date needs to be changed. When ticked, the date and time fields are enabled allowing you to select a new expiry date.</td></tr></tbody></table>
18. The "Change Access" screen will only display if the **Change Access Options** checkbox was ticked on the "Select Changes" screen. If not, go to Step 27.

    This screen allows you to change access options for Access Groups as necessary.

    ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-6055278909997b383fa9af1b27200742a015737e%2Fcholdbc_wizard6.png?alt=media)
19. Click **Manage** from the menu bar, then **Access Groups**.

    The **Access Group** List Window opens.

    Select the Access Groups that the cardholders need adding to and/or removing from, and drag and drop them into the appropriate grids on this screen of the Wizard, then close the **Access Group** List Window.

    ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-647481008f26411dc0466addfc88033e13bb79cb%2Fagintocholdbc.png?alt=media)
20. The 'From' and 'Until' date/time fields on this screen allow temporary membership to an Access Group to be configured if necessary.

    If temporary access is required, go to Step 21.

    If permanent access is required, go to Step 25.
21. Highlight the Access Group (on the **Change Access** screen of the Wizard) the cardholders require temporary access to.

    The 'From' and 'Until' Date fields become enabled.
22. Click the 'From' drop-down box and select the date the cardholders need access to this Access Group from.

    The 'From' Time Box becomes enabled, and the 'From' date now displays in the grid beside the Access Group name.
23. Select the time in the 'From' Time Box that the cardholders need access from on this date.
24. Repeat Steps 21 and 22 for the 'Until' fields, (i.e. the date and time of the last day the cardholders need access up to).

    The 'Until' date now displays in the grid beside the Access Group name.
25. Check the **Remove all Access Group membership as selected** checkbox if required.

    <table><thead><tr><th width="174">If...</th><th>then...</th></tr></thead><tbody><tr><td>checked</td><td>all Access Groups listed in the 'Remove Access' grid will be removed from the nominated Cardholders irrespective of 'From' and 'Until' dates/times, that may or may not have been entered for each Access Group selection.</td></tr><tr><td>unchecked, and no 'From' date/time is entered</td><td>only permanent access will be removed.</td></tr><tr><td>unchecked, and a 'From' date/time is entered</td><td>only one temporary access for that exact period will be removed.</td></tr></tbody></table>
26. Click the **Next** button.
27. The "Change Division" screen will only display if the **Change Division** checkbox was ticked on the "Select Changes" screen. If not, go to Step 29.

    This screen allows you to select a new division to which these cardholders will be changed.

    ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-55432729d9bafbd1ef5f68501eea939d3c12e97a%2Fcholdbc_wizard7.png?alt=media)
28. Select a division from the drop-down list.

    **Note:** Only divisions to which you have "Edit Cardholder" operator privilege will appear in the drop-down list.
29. The "Change Notification Settings" screen will only display if the **Change Visitor Management Notifications** checkbox was ticked on the "Select Changes" screen. If not, go to Step 31.

    This screen allows you to select the notification method that will be assigned to each Cardholder, to indicate the arrival of a visitor.

    ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-5b956fe169bf5b3695374663bdf126a62abb9788%2Fcholdbc_changenotificationsettings.png?alt=media)
30. Select a notification method from the drop-down list, (i.e. "None", "Email", "SMS" or "Email and SMS").
31. The "Save and Start the Bulk Change" 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-48aeb03ab59527c7310eb8c7553148b049f063ba%2Fcholdbc_wizard8.png?alt=media)

    The **Summary of Changes** section provides a summary of the changes for you to check before proceeding.
32. Do you want to save this bulk change and it's settings before running?

    <table><thead><tr><th width="108">If...</th><th>then...</th></tr></thead><tbody><tr><td>no</td><td>go to Step 34.</td></tr><tr><td>yes</td><td>type in a name and description.<br><br><strong>Note:</strong><br>The <strong>Name</strong> field is limited to 60 characters and the <strong>Description</strong> field is limited to 200 characters.</td></tr></tbody></table>
33. Click the **Save** button.

    This Bulk Change and its settings are saved and now displays in the **Bulk Changes** List Window.

    **Note:**

    The **Save As** button allows you to change an existing Bulk Change and re-save it as a new Bulk Change with a different name. If you open an existing saved Bulk Change and click the **Save As** button without changing the name, a message displays indicating that a Bulk Change with that name already exists.
34. Click the **Start** button.

    The "Applying 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-9e71865cd08e2796e6baf9216b65910e7b42b6fd%2Fcholdbc_wizard9.png?alt=media)

    This screen shows the progress of the bulk change. While in progress, the status of this bulk change will show as 'Active' in the **Bulk Changes** List Window, and if it completes successfully, (i.e. the progress bar reaches 100%), the status will change to 'Successful'. When it completes the number of cardholders changed displays.

    **Notes:**

    * If you did not name and save the bulk change before clicking the **Start** button, while the "Applying Changes" screen displays, the bulk change will appear in the **Bulk Changes** List Window with a system-generated name, until is completes successfully, at which time the system will delete it. While it is active or if it fails, it will remain in the **Bulk Changes** List Window until an operator deletes it.
    * If you click the **Stop** button while the bulk change is in progress, any changes already made when it is stopped cannot be cancelled, instead they are completed. If the **Stop** button is clicked, you get the option to end the bulk change, or to go back and edit it.

### Result

A Cardholder Bulk Change has been initiated.


---

# 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/bulk-changes/initiating-a-new-cardholder-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.
