Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?




Hierarchy Level


Configure a limit to the number of MAC addresses that can be learned from a bridge domain, VLAN, virtual switch, or set of bridge domains or VLANs.


For multichassis link aggregation (MC-LAG) peers in active-active mode, configuring the interface-mac-limit statement or changing the interface-mac-limit configuration when traffic is flowing can cause the MAC entries to be out of synchronization between the two MC-LAG peers, which might result in flooding. To avoid flooding, you must either halt traffic forwarding and then configure the interface-mac-limit statement or use the commit at configuration statement to commit the changes at the same time in both the peer nodes.

Alternatively, if flooding does occur, you can clear the bridge MAC table on both the routers or switches by using the clear bridge mac-table command. Running this command ensures that the MAC entries are re-learned and in synchronization between both the peers.


The default MAC limit varies with the platform.


disable—Disables the global interface-mac-limit configuration on an interface and sets the maximum interface-mac-limit that is permitted on the device.

limit—Sets the maximum number of MAC addresses learned from an interface.

  • Range: 1 through <default MAC limit> MAC addresses per interface. Range is platform specific.

If you configure both disable and limit, disable takes precedence and packet-action is set to none. The remaining statement is explained separately.

Required Privilege Level

routing—To view this statement in the configuration.

routing-control—To add this statement to the configuration.

Release Information

Statement introduced in Junos OS Release 8.4.

Support for the switch-options statement added in Junos OS Release 9.2.

Support for top-level configuration for the virtual-switch type of routing instance added in Junos OS Release 9.2. In Junos OS Release 9.1 and earlier, the routing instances hierarchy supported this statement only for a VPLS instance or a bridge domain configured within a virtual switch.

Support for logical systems added in Junos OS Release 9.6.

[edit switch-options], [edit switch-options interface interface-name], [edit vlans vlan-name switch-options], and [edit vlans vlan-name switch-options interface interface-name] hierarchy levels introduced in Junos OS Release 12.3R2 for EX Series switches.