> For the complete documentation index, see [llms.txt](https://documentation.hak5.org/wifi-pineapple-pager/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.hak5.org/wifi-pineapple-pager/wifi-pineapple-commands/ssid_pool.md).
# SSID\_POOL
`PINEAPPLE_SSID_POOL_ADD` - add a SSID to a Pineapple SSID impersonation pool
`PINEAPPLE_SSID_POOL_ADD_FILE` - add multiple SSIDs from a file the Pineapple SSID impersonation pool
`PINEAPPLE_SSID_POOL_DELETE` - delete a SSID from the Pineapple SSID impersonation pool
`PINEAPPLE_SSID_POOL_CLEAR` - clear the Pineapple SSID impersonation pool
`PINEAPPLE_SSID_POOL_LIST` - show a Pineapple SSID impersonation pool
`PINEAPPLE_SSID_POOL_COLLECT_START` - start automatic SSID collection mode
`PINEAPPLE_SSID_POOL_COLLECT_STOP` - stop automatic SSID collection mode
`PINEAPPLE_SSID_POOL_START` - start advertising SSIDs from the impersonation pool
`PINEAPPLE_SSID_POOL_STOP` - stop advertising SSIDs from the impersonation pool
### When to use them
The [Pineapple SSID impersonation pool](/wifi-pineapple-pager/ssid-pool.md) is a mechanism to entice clients to attempt connecting to a Pineapple Open access point with [mimicry enabled](/wifi-pineapple-pager/pineapple-open-ap.md).
Use the `PINEAPPLE_SSID_POOL_` to manipulate the behavior of the SSID impersonation from a payload or command line.
### Syntax
```none
PINEAPPLE_SSID_POOL_ADD [ssid] {ssid2 ... ssidN}
```
**ssid**
One or more SSIDs to add to the impersonation pool. If the SSID contains special characters or spaces, be sure to use quotes!
```none
PINEAPPLE_SSID_POOL_ADD_FILE [file]
```
**file**
File containing one or more SSIDs, one SSID per line, to add to the SSID pool.
```none
PINEAPPLE_SSID_POOL_DELETE [ssid] {ssid2 ... ssidN}
```
**ssid**
One or moree SSIDs to delete from the advertisement pool. If the SSID contains special characters or spaces, be sure to use quotes!
```none
PINEAPPLE_SSID_POOL_CLEAR
```
Clear the SSID pool
```none
PINEAPPLE_SSID_POOL_LIST
```
List the contents of the SSID pool
```none
PINEAPPLE_SSID_POOL_COLLECT_START
```
Start collecting SSIDs from probe requests, adding them to the SSID pool automatically.
```none
PINEAPPLE_SSID_POOL_COLLECT_STOP
```
Stop automatic collection of SSIDs in probe requests.
```none
PINEAPPLE_SSID_POOL_START {randomize}
```
**randomize (optional)**
Randomize (`true`) the impersonated BSSID of the advertised network, or use the BSSID of the Pineapple Open access point (`false`).
Many clients will not successfully connect to the Pineapple Open access point if a random BSSID is used; however, some clients will request any AP with the advertised SSID.
```none
PINEAPPLE_SSID_POOL_STOP
```
Stop advertising the SSID pool.
### Results
`PINEAPPLE_SSID_POOL_START` requires that the Pineapple Open AP is enabled and Mimicry mode is turned on, and will exit with an error code if they are not.
### Examples
```bash
PINEAPPLE_SSID_POOL_STOP
PINEAPPLE_SSID_POOL_CLEAR
PINEAPPLE_SSID_POOL_ADD "Random Network"
PINEAPPLE_SSID_POOL_ADD "Free Public Wi-Fi"
PINEAPPLE_SSID_POOL_START
```
---
# 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://documentation.hak5.org/wifi-pineapple-pager/wifi-pineapple-commands/ssid_pool.md?ask=&goal=
```
`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.