> 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/command-centre-client/using-command-centre/licensable-features/uk-govpass-card-support/uk-govpass-cards-in-command-centre/enrolling-govpass-cards.md).

# Enrolling GovPass cards

To assign and activate a Cardholder GovPass card, perform the following procedure in Gallagher Command Centre Client:

1. From the Cardholder Viewer, locate the Cardholder you want to assign a GovPass card to.
2. On the Cardholder Cards tile, click the **Assign Card** button.
3. From the **Card Type** drop-down list select the GovPass Card Type.

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

   Once the GovPass Card Type is selected a **Visitor/Contractor** checkbox appears, allowing you to specify whether or not it is a visitor or contractor card.
4. The **State** indicates the status of the GovPass Card Type.

   Select the appropriate **State** from the drop-down list.

   ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-098f43566f002f8e1a67e1f098e0dd32e586ca0b%2Fgovpass_assigncardpopup_states.png?alt=media)

<details>

<summary>Click here for a description of the available states</summary>

<table><thead><tr><th width="148">State</th><th>Description</th></tr></thead><tbody><tr><td>Produced *</td><td>A GovPass card that has been encoded but not issued to a site. This should not occur at live sites, and will trigger an alarm.</td></tr><tr><td>Active</td><td>An active GovPass card that can be enrolled at other locations.</td></tr><tr><td>Issued</td><td>A GovPass card that has been issued to a site but not yet enrolled for the first time</td></tr><tr><td>BuildingOnly</td><td>This is reserved for GovPass cards allocated for use as 'Visitor' or 'Contractor' passes that should not be used for access to any other building. Cards enrolled with this state will trigger an alarm if not owned by the requesting building.</td></tr><tr><td>Lost *</td><td>The GovPass card has been reported as 'Lost' by its Issuing Building, and an alarm will be triggered.</td></tr><tr><td>Revoked *</td><td>When a GovPass card has been returned to the pass office or taken away from a user.</td></tr><tr><td>Expired *</td><td>Where the validity date of a GovPass card has expired, (i.e. the holder’s clearance or contract has expired/ended).</td></tr><tr><td>Inactive *</td><td>This state is reserved for future use where a pass has been disabled. It will trigger an alarm.</td></tr></tbody></table>

\* When a GovPass card is enrolled with a bad state, (i.e. *Produced*, *Lost*, *Revoked*, *Expired* or *Inactive*), the card will fail enrolment. An alarm will generate and the following error message will display:

![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-460a367df3e8cafa7267b9a3f3c78d9ca3a8d941%2Fbadstate_errormessage.png?alt=media)

</details>

5. Configure the **Number**, **From** and **Until** fields as appropriate.
6. If required, check the Visitor/Contractor checkbox to prevent the card from being enrolled at other sites.

   **Notes:** Cards of this type won't be enabled on other servers.
7. Click the **OK** button.

   **Note:** Once **OK** has been clicked, the Visitor/Contractor setting cannot be modified.

   If valid, the **Assign Card** pop-up will close and the card will appear in the grid in the Cardholder Cards tile.
8. To display site information for the GovPass Card Type, click on the arrowhead to the left of GovPass Card Type.

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

   In the above example, "Visitor/Contractor" = Yes because the **Visitor/Contractor** checkbox was checked during enrolment, and "Owned by Site" = Yes the site that enrolled this card was identified as the owner of the card by the GovPass API.
9. Click the **Save** button.

   **Note:** The **History** tab of a cardholder’s properties (in Configuration Client) will also show what has been set during enrolment.

   ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-21f4a5ce8a8dacf6395bd2d361463ea186eb0845%2Fcardholdershistory.png?alt=media)

### Offline enrolment

It is possible to enrol GovPass cards when GovPass Check service is offline to Command Centre. In this situation the card is activated and its status in Command Centre is updated to 'Unverified'. Also, an alarm is raised for this unverified credential enrolment.

![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-0f5a506121db8609c92668f6cb2e0281a11d3047%2Fofflineenrolment_unverified.png?alt=media)


---

# 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/command-centre-client/using-command-centre/licensable-features/uk-govpass-card-support/uk-govpass-cards-in-command-centre/enrolling-govpass-cards.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.
