> For the complete documentation index, see [llms.txt](https://docs.roamingiq.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roamingiq.com/network-administrator-console/network-operator-settings/keypools.md).

# Keypools

### What are Keypools?

A keypool is essentially a reservoir of keys, or Wi-Fi passwords, along with the corresponding SSID for authentication purposes.

VAULT has two types of keypools.

1. Global: A global keypool is available at all venues. Any subscriber's Wi-Fi password, or PSK, in that keypool will work at all venues. We recommend always using a global keypool and broadcasting the same SSID at all venues, for example, "RoamingiQ Wi-Fi."
2. Local: A local keypool is exclusive to one specific venue. Any subscriber's Wi-Fi password, or PSK, in that keypool will only work at that venue with that local keypool.
   1. However, if you also have a global keypool, any Wi-Fi passwords associated with the local keypool will also "roll up" to work with the global keypool.

### How to Create Keypools

{% embed url="<https://scribehow.com/shared/How_to_Create_a_Keypool_in_VAULT__XjqDPhY2TQaO41wQPTcuUQ>" %}

You may also create a new keypool while creating or modifying a venue within the [venue settings](/network-administrator-console/creating-a-new-venue/add-a-keypool-to-a-venue.md).

#### Keypool Scope and Display Order

After you have created a keypool, you will see two additional values.

1. Scope:  A scope is either "global," meaning it is a global keypool, or a random string of system-generated characters, indicating it is a local keypool.
2. Display Order:  If multiple keypools are available at a venue, the keypool with the lowest display order will appear by default when the subscriber logs into their VAULT account.

As a best practice, ensure a local keypool at a Venue has a lower display order value than a global keypool at a Venue.

###


---

# 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 dynamically by asking a question.

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

```
GET https://docs.roamingiq.com/network-administrator-console/network-operator-settings/keypools.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
