> 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
```