# Manage Host Lists in Guest

In Verkada Guest, hosts are users authorized to receive visitors and manage Guest Events. Host Lists determine which users are eligible to be selected as hosts and can send visitor invitations on behalf of your organization.

***

## Manage Hosts Lists in Guest

Host Lists can be configured at the site level or organization-wide. Site-specific Host Lists help ensure that employees are only available to receive visitors at locations where they are authorized to host.

### Organization-level Host List

{% hint style="danger" %}
You need at least **Org Admin** permissions to configure the organization Level Hosts List.
{% endhint %}

{% stepper %}
{% step %}
**In Verkada Command, go to All Products > Workplace > Guest.**
{% endstep %}

{% step %}
**On the left navigation, click Guest Settings > Organization.**
{% endstep %}

{% step %}
**Under Hosts, click View employees > Manage Employees.**
{% endstep %}

{% step %}
**Select a method to** [**add a host**](#h_0fe34449bd)**.**
{% endstep %}
{% endstepper %}

### Site-specific Host List

{% hint style="danger" %}
You need at least **Workplace Site Admin** permissions to configure a Site Level Host List.
{% endhint %}

{% stepper %}
{% step %}
**In Verkada Command, go to All Products > Workplace > Guest.**
{% endstep %}

{% step %}
**On the left navigation, click Guest Settings.**
{% endstep %}

{% step %}
**Select Sites > your site.**
{% endstep %}

{% step %}
**Under Hosts, click View employees > Manage Employees.**
{% endstep %}

{% step %}
**Select a method to** [**add a host**](#h_0fe34449bd)**.**
{% endstep %}
{% endstepper %}

***

### Add Hosts

Hosts can be added to a Host List using one of the following methods:

* **Manually add individual hosts**: Create a new host profile by providing an email, name, photo, and phone number.
* **Bulk upload CSV**: Set up host profiles in bulk with a CSV upload.
* **Sync with an identity provider**: Sync a host list with an existing Command Group. This method lets organizations automate updates to the host list by connecting to a SCIM-managed Command group.

All 3 ways of adding hosts can be used for one list.

#### Manually add individual hosts

{% stepper %}
{% step %}
[**Go to the desired Host List**](#manage-hosts-lists-in-guest)**.**
{% endstep %}

{% step %}
**Click Manage employees.**
{% endstep %}

{% step %}
**Click Add individual.**

a. Add an email for the host.\
b. Add a name for the host.\
c. (Optional) Add a phone number for the host.\
d. (Optional) Add a photo for the host.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
If the email matches an existing host or Command user, the host profile is automatically linked and cannot be edited. The name and phone number will inherit from the associated Command user profile.
{% endhint %}

#### Bulk upload CSV

{% stepper %}
{% step %}
[**Go to the desired Host List**](#manage-hosts-lists-in-guest)**.**
{% endstep %}

{% step %}
**Click Manage employees.**
{% endstep %}

{% step %}
**Click Bulk upload CSV.**
{% endstep %}

{% step %}
**Click Upload new CSV.**
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
**Only one** CSV can be uploaded for a Host List.
{% endhint %}

#### Sync with an identity provider

{% stepper %}
{% step %}
[**Go to the desired Host List**](#manage-hosts-lists-in-guest)**.**
{% endstep %}

{% step %}
**Click Manage employees.**
{% endstep %}

{% step %}
**Click Sync with an identity provider.**
{% endstep %}

{% step %}
**Select a Command group from the list.**
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
**Only one** Command group can be synced with a Host List.
{% endhint %}

The Host List syncs with the associated Command group every 24 hours. To apply changes immediately, you can manually trigger a sync:

{% stepper %}
{% step %}
[**Go to the desired Host List**](#manage-hosts-lists-in-guest)**.**
{% endstep %}

{% step %}
**Click Sync now.**
{% endstep %}
{% endstepper %}

***

### Use the Organization Host List for a Guest Site

By default, new Guest sites inherit the **organization-level Host List**. A site-specific Host List can either sync with the organization list or be managed independently.

To switch to a site-specific Host List:

{% stepper %}
{% step %}
**Navigate to the desired site-level Host List.**
{% endstep %}

{% step %}
**Click Use site-specific employees.**
{% endstep %}
{% endstepper %}

A Workplace Site Admin can configure a site-level Host List to use the organization-level Host List instead. To apply the organization’s Host List to a site:

{% stepper %}
{% step %}
**Navigate to the desired site-level Host List.**
{% endstep %}

{% step %}
**Click Manage employees.**
{% endstep %}

{% step %}
**Select Use employee list from \[organization name].**

<div align="left" data-with-frame="true"><img src="/files/IhtNxThBbNeGrH6is6GP" alt=""></div>
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
The organization-level Host List is only visible to Org Admins.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.verkada.com/guest/configuration/manage-host-lists-in-guest.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.