Skip to main content
Pedro_FTNT
Staff
Staff
April 30, 2026

Technical Tip: Deleting a VLAN with zero references on FortiLink removes the associated switch configuration

  • April 30, 2026
  • 0 replies
  • 27 views

Description

This article describes the behavior observed when deleting a VLAN with zero references on a FortiLink interface and why it can remove the associated switch configuration.

Scope

FortiGate, FortiSwitch, FortiOS v7.x and later.

Solution

Overview:
In a FortiLink environment, VLAN interfaces are tightly integrated with FortiSwitch configuration. VLANs define both Layer 3 interfaces and Layer 2 switching domains across managed switches.

Deleting a VLAN interface may affect switch configuration, even when no explicit references are displayed.


Behavior explanation:
A VLAN configured on a FortiLink interface is used to:

  • Define broadcast domains across FortiSwitch devices.

  • Associate switch ports to specific VLANs.

  • Maintain internal mappings between FortiGate and FortiSwitch configurations.

  • Synchronize configuration changes across managed switches.


When a VLAN is deleted, FortiGate removes:

  • The VLAN interface.

  • Associated internal mappings.

  • VLAN membership from switch ports.

  • Related switch configuration elements.


Even if the VLAN shows zero references in the configuration, implicit dependencies may still exist through:

  • FortiLink internal mappings.

  • Switch port VLAN assignments.

  • Default or dynamically applied configurations.

As a result, deleting the VLAN can remove switch port configuration and require reconfiguration.


Impact:
Deleting a VLAN on FortiLink may result in:

  • Loss of VLAN assignments on FortiSwitch ports.

  • Removal of associated Layer 2 domains.

  • Disruption of traffic for connected devices.

  • Requirement to manually reconfigure affected switch ports.


Verification:

  1. Go to WiFi & Switch Controller -> FortiSwitch Ports.

  2. Verify VLAN assignments on switch ports.

  3. Go to Network -> Interfaces.

  4. Review VLAN interfaces associated with FortiLink.


Expected result:
VLAN interfaces are associated with switch port configuration and FortiLink management.

Additional validation (CLI):


show system interface
show switch vlan


Expected result:
VLAN interfaces and switch VLAN mappings are displayed.

Troubleshooting:

  • If the switch configuration is removed after deleting a VLAN, perform the following checks:
    Verify VLAN assignment on switch ports.

  • Go to WiFi & Switch Controller -> FortiSwitch Ports.

Expected result:
Switch ports show correct VLAN assignments.

If VLAN assignments are missing, reassign the VLAN to affected ports.
Verify existing VLAN configuration.

Run:

show switch vlan


Expected result:
Required VLANs are present in the configuration.

If the VLAN is missing, recreate the VLAN interface.

Verify FortiLink synchronization status.

Run:

diagnose switch-controller dump status


Expected result:
FortiLink status shows synchronized configuration.

If synchronization issues are detected, review FortiLink connectivity.

Verify interface configuration.

Run:

show system interface


Expected result:
VLAN interfaces are correctly defined and associated with FortiLink.


Verify traffic impact.

Check connectivity from affected devices.

Expected result:

Traffic flows correctly through assigned VLANs.

If connectivity fails, verify:

  1. VLAN assignment.

  2. Interface configuration.

  3. Firewall policies.

  • Validate configuration changes.

Review recent configuration changes related to VLAN removal.

Expected result:
Changes align with expected configuration behavior.

  • Best practices:

  1. Verify switch port VLAN assignments before deleting a VLAN.

  2. Remove VLAN assignments from switch ports before deletion.

  3. Validate that no implicit dependencies exist.

  4. Perform configuration changes during a maintenance window.

  5. Back up configuration before modifying VLANs in a FortiLink environment.


  • Additional notes:

  1. FortiLink centrally manages FortiSwitch configuration from FortiGate.

  2. VLAN changes are synchronized across all managed switches.

  3. Configuration updates may affect multiple switches simultaneously.

  4. Implicit dependencies may not be visible in reference counters.