Support Downloads Community

UniFi Video is an obsolete product line.

This application and its related devices will no longer receive any manner of technical support, including functional and security updates. Additionally, there will be no further updates to Help Center content pertaining to UniFi Video.

UniFi - USW: Configuring Link Aggregation Groups (LAG)


This article explains how to configure link aggregation on the UniFi Switch devices, as well as what considerations should be taken into account when configuring a link aggregation group. 

NOTES & REQUIREMENTS: Applicableto all UniFi Switch models excluding the USW-Flex and USW-Flex-Mini. 

Table of Contents

  1. Introduction
  2. Network Diagram
  3. Steps: How to Configure Link Aggregation Groups
    1. Key Considerations
  4. Verification
  5. Related Articles


Back to Top

Configuring the UniFi switches with a link aggregation group (LAG) allows a UniFi Administrator to be able to expand the maximum throughput on a network path.

Link Aggregation Control Protocol (LACP) is a dynamically negotiated protocol that ensures that the LAG configuration is compatible and viable on each endpoint. LACP also provides the ability for the load balancing to failover in the event that one of the bundled links were to fail. 

Network Diagram

Back to Top


Steps: How to Configure Link Aggregation Groups

Back to Top

  1. Navigate to the Devices section in the UniFi Network application and click on the switch to open the Properties Panel.
  2. In the Properties Panel, go to the Ports section and select a port that will participate in the link aggregation group by selecting Edit (pencil icon) when hovering over it.
  3. Click Profile Overrides to expand section.
  4. Under Operations, select Aggregate. This will expose some Aggregate options.
  5. Under the Aggregate Ports input which ports to include in the LAG.
  • Take note of the warning about order of operations when enabling the link aggregation group. 
  • Both LAGs on the connecting devices must have the same port profile. Port numbers do not have to match. 

Key Considerations


  • Up to six ports may be configured in the LAG. These ports must be sequential in number.
  • Up to six individual LAGs can be configured. 
  • Static LAG configurations are not supported. LACP (802.3ad) only. 
  • No Multi-chassis Link Aggregation Group (MLAG). 

Spanning Tree Protocol (STP)

When defining a LAG it is important to understand that the STP port cost is divided by however many active links are participating in the LAG. 


 Number of Ports LAG STP Port Cost
4x 1Gbps ports (20,000 original port cost) 5,000
2x 10Gbps ports (2,000 original port cost) 1,000 

A LAG may alter the best path based on the port cost to the root bridge. Be certain that an administratively-defined root bridge is selected. 

Order of Operations

When enabling link aggregation between UniFi switches it is important to retain access to the Network application for provisioning to take place. When enabling the LAG on the devices be certain that configuration changes are first done on the downstream switch, and then on the upstream switch. 

NOTE: The terms "upstream" and "downstream" are used relationally in accordance with the path to the UniFi OS Console, or your Network application host.

LACP Algorithm

  • Hashing based on Source/Destination MAC, VLAN, EtherType, and incoming port associated with the packet


Throughput testing with one host to another single host will not show improvements. The hashing algorithm that is used for LACP does not split data streams on single host-to-host connections. To see improvements in throughput multiple hosts would have to be passing traffic at the same time. 


Back to Top

CLI: Access the command line interface (CLI). You can do this using the debug terminal in the GUI or by using a program such as PuTTY.
  • View counters on LAG:

show interface lag #

  • View LACP partners on all ports:

show lacp partner all

Related Articles

Back to Top

UniFi - USW: Configuring Spanning Tree Protocol

Was this article helpful?
260 out of 351 found this helpful