Skip to content

Group devices with MAC lists

A MAC list (static host list) is a named group of addresses: exact MACs, vendor prefixes (OUIs) or regular expressions. An access policy rule with the condition Device is in MAC list then matches every device in the list. Use MAC lists when you know the devices of a group, for example the printers of a site, or every device of one camera vendor.

  • An administrator role with identity:write for the lists and policy:write for the rules.
  • MAC authentication on the network and an access policy for MAC authentication, see Devices by MAC address.
  1. Open Devices › MAC lists and select Add host list.

  2. Fill in:

    Field Value
    Name Printers (required)
    Description optional
    Host type MAC address (or IP address)
    Host format List: exact addresses; partial MACs match as prefixes. Subnet / prefix: MAC prefixes or OUIs such as aa:bb:cc or aa:bb:cc:00:00:00/24 (for IP lists: CIDRs such as 10.0.0.0/8 and ranges such as 10.0.0.1-50). Regular expression: RE2 expressions, unanchored.
  3. Add entries:

    • Add entry for one value and an optional description.
    • Bulk add to paste many: one per line, value or value,description (comma, semicolon or tab). A header row is skipped.
    • Import CSV to load a file in the same format.
  4. Select Save.

Values are normalised on save: MACs become aa:bb:cc:dd:ee:ff, subnets are masked, ranges expanded, duplicates dropped. A list holds up to 10,000 entries.

Example bulk input:

aa:bb:cc:00:11:22,Lobby printer
aa:bb:cc:00:11:23,Finance printer
00-11-22-33-44-55
  1. Open Access › Access policies and the MAC authentication policy.
  2. Add a rule (or edit one), Add condition, choose Device is in MAC list and pick Printers.
  3. Set Then: Allow, VLAN 40 (and an ACL if you need one).
  4. Select Done, then Save changes.

The condition is Connection:Client-Mac-Address BELONGS_TO_GROUP Printers. Renaming a list rewrites the rules that use it.

On Devices › MAC lists, each list has Export CSV, Clone, Edit and Delete. Opening a list shows a summary and Referenced by: the rules that use it. A list that a rule still uses cannot be deleted; the console names the rules (Host list is in use). Remove it from the rules first.

  • Access › Test access, A device (MAC address), with a MAC from the list: the result shows the rule that uses the list.
  • Monitor › Sign-in log: the device’s MAB request with the rule name.
Symptom Cause Fix
Sign-in log: Denied: no rule of the policy allowed this device, although the MAC is in the list The list is a Subnet / prefix list with a wrong prefix length, or the entry has a typo. Open the list and check the entry; test the MAC in Test access.
A device matches the wrong rule A rule above (for example Device is Known) matched first. Move the MAC list rule up.
Vendor prefix lists do not match phones or laptops Phones and laptops use random (private) MAC addresses, which carry no vendor prefix. Use MAC lists for headless devices; identify users’ devices by certificate.
Deleting fails with Host list is in use A rule uses the list. Remove the condition from the rule and save, then delete.
© 2026 Airowire Networks Pvt. Ltd. Airgate is a product of Airowire.Product · Release notes · Security