> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trurisk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Contacts and Client Portal access

> Manage client contacts and invite a contact to become the client's Client Portal administrator.

**Contacts** are the people at a client that you work with. They're stored on the **Contacts** tab of the client record (and of each site they're associated with).

Contacts don't have a login to TruRisk. They're a list for your own reference, and they're used for email notifications: when a contact is assigned to a recommendation, they receive an email whenever an engineer posts a response on it. See [The recommendation record](https://docs.trurisk.io/the-recommendation-record.md#responses).

## Adding a contact

1. Open the client record and go to the **Contacts** tab.
2. Click **Add Contact**.
3. Enter the contact's details — name, **Job Title**, **Email**, and **Phone Number** — and select the **Site(s)** they're associated with.
4. Save the contact.

The **`···`** menu on each contact's row has the following options:

* **Promote Contact** — make the contact the client admin (see below)
* **Edit** — update the contact's details
* **Delete** — remove the contact

## Inviting a client to the Client Portal

Once you've completed and issued the client's first survey, promote their main contact to **client admin** to give the client access to the Client Portal. This turns the contact into a real user with client administration permissions — they can log in to view published survey documents, manage recommendations, invite other users, and more.

You can promote a contact in either of two ways:

* Open the **`···`** menu on the contact's row and select **Promote Contact**.
* Open the contact's **Edit** form and promote them from there.

![The Promote Contact option in a contact's row menu](https://mintcdn.com/trurisk/jBMa2A4lgObr_z1r/images/guide/contacts-promote.png?fit=max\&auto=format\&n=jBMa2A4lgObr_z1r\&q=85\&s=2e660d6e891563147e3446f26813cfe3)

A confirmation window asks you to **Enable portal access** for the contact. Click **Enable Access** to confirm.

![The Enable portal access confirmation window](https://mintcdn.com/trurisk/jBMa2A4lgObr_z1r/images/guide/contacts-enable-access.png?fit=max\&auto=format\&n=jBMa2A4lgObr_z1r\&q=85\&s=baa0129cda81c7bbe9a4af9f97f3333c)

Once promoted:

* The client's status changes to **Active** automatically.
* The contact receives an email inviting them to the Client Portal.
* A **crown icon** appears next to their name in the Contacts list to show they're the client admin.

> [!NOTE]
>
> You can only promote **one** contact per client. From then on, the client admin manages their own users from within the Client Portal — for example, adding site managers who complete activities at individual sites. If the client admin loses access or has problems with the portal, contact your TruRisk administrator.

> [!TIP]
>
> Before you promote a contact, use **Preview** to check exactly what the client will see. See [Previewing the client portal](https://docs.trurisk.io/previewing-the-client-portal.md).

The recommended order is:

1. Complete the client's first survey and [issue the report](https://docs.trurisk.io/issuing-a-survey-report.md).
2. [Preview](https://docs.trurisk.io/previewing-the-client-portal.md) the Client Portal.
3. Add the client's main contact and **Promote Contact** — portal access is enabled automatically.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.