diff --git a/docs/resources/virtual_environment_network_linux_bridge.md b/docs/resources/virtual_environment_network_linux_bridge.md
index 5826ae670..064a11fc1 100644
--- a/docs/resources/virtual_environment_network_linux_bridge.md
+++ b/docs/resources/virtual_environment_network_linux_bridge.md
@@ -27,9 +27,22 @@ resource "proxmox_virtual_environment_network_linux_bridge" "vmbr99" {
   comment = "vmbr99 comment"
 
   ports = [
+    # Network (or VLAN) interfaces to attach to the bridge, specified by their interface name
+    # (e.g. "ens18.99" for VLAN 99 on interface ens18).
+    # For VLAN interfaces with custom names, use the interface name without the VLAN tag, e.g. "vlan_lab"
     "ens18.99"
   ]
 }
+
+resource "proxmox_virtual_environment_network_linux_vlan" "vlan99" {
+  node_name = "pve"
+  name      = "ens18.99"
+
+  ## or alternatively, use custom name:
+  # name      = "vlan_lab"
+  # interface = "eno0"
+  # vlan      = 98
+}
 ```
 
 <!-- schema generated by tfplugindocs -->
diff --git a/examples/resources/proxmox_virtual_environment_network_linux_bridge/resource.tf b/examples/resources/proxmox_virtual_environment_network_linux_bridge/resource.tf
index 9b10607e9..6d85d49e6 100644
--- a/examples/resources/proxmox_virtual_environment_network_linux_bridge/resource.tf
+++ b/examples/resources/proxmox_virtual_environment_network_linux_bridge/resource.tf
@@ -11,6 +11,19 @@ resource "proxmox_virtual_environment_network_linux_bridge" "vmbr99" {
   comment = "vmbr99 comment"
 
   ports = [
+    # Network (or VLAN) interfaces to attach to the bridge, specified by their interface name
+    # (e.g. "ens18.99" for VLAN 99 on interface ens18).
+    # For VLAN interfaces with custom names, use the interface name without the VLAN tag, e.g. "vlan_lab"
     "ens18.99"
   ]
 }
+
+resource "proxmox_virtual_environment_network_linux_vlan" "vlan99" {
+  node_name = "pve"
+  name      = "ens18.99"
+
+  ## or alternatively, use custom name:
+  # name      = "vlan_lab"
+  # interface = "eno0"
+  # vlan      = 98
+}