# Scan lists

Scan lists are simple lists of channels to scan. A scan list might be associated with a channel.

As an example, consider the following scan list:

##

    scanLists:
      - id: scan1
        name: KW
        channels: [ch4, ch5, ch76, ch77, ch97, ch102, ch68, ch112]

This scan list has the ID scan1, the name KW and contains several channels (both analog and digital).

## Scan list fields

id

- Specifies the ID of the scan list. This ID can then be used to reference this scan list in cpChannels.

name

- Specifies the name of the scan list. Any string is valid here.

primary

- Specifies the primary priority channel. Usually this channel is scanned very frequently. If set, this must be a reference to a channel. If the tag !selected is used here, the channel from which the scan got started is used as the primary priority channel.

secondary

- Specifies the secondary priority channel. Usually this channel is scanned frequently. If set, this must be a reference to a channel. If the tag !selected is used here, the channel from which the scan got started is used as the secondary priority channel.

revert

- Specifies the revert channel. That is, the channel to transmit on irrespective of the current channel being scanned. If set, this must be a reference to a channel. If the tag !selected is used here, the channel from which the scan got started is used as the transmit channel. If omitted the radio will transmit on the currently scanned channel.

channels

- Specifies the list of channels to scan. Must be a list of channel IDs.