diff --git a/charts/spiderpool/crds/spiderpool.spidernet.io_spiderippools.yaml b/charts/spiderpool/crds/spiderpool.spidernet.io_spiderippools.yaml
index 948e74be3b..880338cffd 100644
--- a/charts/spiderpool/crds/spiderpool.spidernet.io_spiderippools.yaml
+++ b/charts/spiderpool/crds/spiderpool.spidernet.io_spiderippools.yaml
@@ -273,6 +273,7 @@ spec:
                 type: string
               vlan:
                 default: 0
+                description: 'DEPRECATED: Vlan is deprecated.'
                 format: int64
                 maximum: 4094
                 minimum: 0
diff --git a/charts/spiderpool/crds/spiderpool.spidernet.io_spidersubnets.yaml b/charts/spiderpool/crds/spiderpool.spidernet.io_spidersubnets.yaml
index 41fa46d5ce..c44aab2165 100644
--- a/charts/spiderpool/crds/spiderpool.spidernet.io_spidersubnets.yaml
+++ b/charts/spiderpool/crds/spiderpool.spidernet.io_spidersubnets.yaml
@@ -87,6 +87,7 @@ spec:
                 type: string
               vlan:
                 default: 0
+                description: 'DEPRECATED: Vlan is deprecated.'
                 format: int64
                 maximum: 4094
                 minimum: 0
diff --git a/docs/reference/crd-spiderippool.md b/docs/reference/crd-spiderippool.md
index 764f604427..f1d88d5512 100644
--- a/docs/reference/crd-spiderippool.md
+++ b/docs/reference/crd-spiderippool.md
@@ -42,7 +42,7 @@ This is the IPPool spec for users to configure.
 | ips               | IP ranges for this pool to use                                                                             | list of strings                                                                                                                        | optional   | array of IP ranges and single IP address |         |
 | excludeIPs        | isolated IP ranges for this pool to filter                                                                 | list of strings                                                                                                                        | optional   | array of IP ranges and single IP address |         |
 | gateway           | gateway for this pool                                                                                      | string                                                                                                                                 | optional   | an IP address                            |         |
-| vlan              | vlan ID                                                                                                    | int                                                                                                                                    | optional   | [0,4094]                                 | 0       |
+| vlan              | vlan ID(deprecated)                                                                                        | int                                                                                                                                    | optional   | [0,4094]                                 | 0       |
 | routes            | custom routes in this pool (please don't set default route `0.0.0.0/0` if property `gateway` exists)       | list of [route](./crd-spiderippool.md#Route)                                                                                           | optional   |                                          |         |
 | podAffinity       | specify which pods can use this pool                                                                       | [labelSelector](https://github.com/kubernetes/kubernetes/blob/v1.27.0/staging/src/k8s.io/apimachinery/pkg/apis/meta/v1/types.go#L1195) | optional   | kubernetes LabelSelector                 |         |
 | namespaceAffinity | specify which namespaces pods can use this pool                                                            | [labelSelector](https://github.com/kubernetes/kubernetes/blob/v1.27.0/staging/src/k8s.io/apimachinery/pkg/apis/meta/v1/types.go#L1195) | optional   | kubernetes LabelSelector                 |         |
diff --git a/docs/reference/crd-spidersubnet.md b/docs/reference/crd-spidersubnet.md
index 48e7a5b79b..a00fb8e0d6 100644
--- a/docs/reference/crd-spidersubnet.md
+++ b/docs/reference/crd-spidersubnet.md
@@ -40,7 +40,7 @@ This is the SpiderSubnet spec for users to configure.
 | ips               | IP ranges for this resource to use             | list of strings                              | optional   | array of IP ranges and single IP address |         |
 | excludeIPs        | isolated IP ranges for this resource to filter | list of strings                              | optional   | array of IP ranges and single IP address |         |
 | gateway           | gateway for this resource                      | string                                       | optional   | an IP address                            |         |
-| vlan              | vlan ID                                        | int                                          | optional   | [0,4094]                                 | 0       |
+| vlan              | vlan ID(deprecated)                            | int                                          | optional   | [0,4094]                                 | 0       |
 | routes            | custom routes in this resource                 | list of [Route](./crd-spiderippool.md#Route) | optional   |                                          |         |
 
 ### Status (subresource)
diff --git a/pkg/k8s/apis/spiderpool.spidernet.io/v2beta1/spiderippool_types.go b/pkg/k8s/apis/spiderpool.spidernet.io/v2beta1/spiderippool_types.go
index fed7d83a54..3951798f0a 100644
--- a/pkg/k8s/apis/spiderpool.spidernet.io/v2beta1/spiderippool_types.go
+++ b/pkg/k8s/apis/spiderpool.spidernet.io/v2beta1/spiderippool_types.go
@@ -25,6 +25,7 @@ type IPPoolSpec struct {
 	// +kubebuilder:validation:Optional
 	Gateway *string `json:"gateway,omitempty"`
 
+	// DEPRECATED: Vlan is deprecated.
 	// +kubebuilder:default=0
 	// +kubebuilder:validation:Maximum=4094
 	// +kubebuilder:validation:Minimum=0
diff --git a/pkg/k8s/apis/spiderpool.spidernet.io/v2beta1/spidersubnet_types.go b/pkg/k8s/apis/spiderpool.spidernet.io/v2beta1/spidersubnet_types.go
index e07df21721..a9459b6da3 100644
--- a/pkg/k8s/apis/spiderpool.spidernet.io/v2beta1/spidersubnet_types.go
+++ b/pkg/k8s/apis/spiderpool.spidernet.io/v2beta1/spidersubnet_types.go
@@ -25,6 +25,7 @@ type SubnetSpec struct {
 	// +kubebuilder:validation:Optional
 	Gateway *string `json:"gateway,omitempty"`
 
+	// DEPRECATED: Vlan is deprecated.
 	// +kubebuilder:default=0
 	// +kubebuilder:validation:Maximum=4094
 	// +kubebuilder:validation:Minimum=0