Skip to main content
Cisco SD-WAN
Product Documentation
Viptela Documentation


rewrite-rule—Configure a rewrite rule to overwrite the DSCP field of a packet's outer IP header, mark transit traffic with an 802.1p CoS value, and apply a rewrite rule on an interface (on vEdge routers only). A rewrite rule is applied to packets being transmitted out the interface.

You can apply rewrite rules to both unicast and multicast traffic.

vManage Feature Template

For vEdge routers only:

Configuration ► Policies ► Localized Policy
Configuration ► Templates ► VPN Interface Cellular (for vEdge cellular wireless routers only)
Configuration ► Templates ► VPN Interface Ethernet
Configuration ► Templates ► VPN Interface GRE
Configuration ► Templates ► VPN Interface PPP
Configuration ► Templates ► VPN Interface PPP Ethernet

Command Hierarchy

Create a Rewrite Rule

  rewrite-rule rule-name
    class class-name loss-priority dscp dscp-value layer-2-cos number

Apply a Rewrite Rule on an Interface

vpn vpn-id
  interface interface-name
    rewrite-rule rule-name


Class-of-Service Value
layer-2-cos number
Number of an 802.1p CoS value to use to mark transit traffic.
Range: 0 through 7
DSCP Value
dscp dscp-value
Assign a DSCP value to transit traffic.
Range: 0 through 63
Forwarding Class Name
class class-name
Name of the forwarding class.
Loss Priority
Packet loss priority (PLP) for the forwarding class.
Values: high, low
Rewrite Rule Name
Name of the QoS map. It can be a text string from 1 through 32 characters long. When you apply a rewrite rule to an interface, the name must match one that you specified when you created the rule with the policy rewrite-rule configuration command.

Cisco IOS XE SD-WAN supports maximum of 64 entries only per rewrite rule. 


Create a rewrite rule, and apply it to an interface:

vEdge(config)# show config
rewrite-rule transport
 class af1 low dscp 3
 class af1 high dscp 4
 class af2 low dscp 5
 class af2 high dscp 6
 class af3 low dscp 7
 class af3 high dscp 8
 class be low dscp 1
 class be high dscp 2
vpn 0
interface ge0/0
  no shutdown
  rewrite-rule transport

Release Information

Command introduced in Viptela Software Release 14.1.​
In Release 16.3, add support for multicast traffic.
In Release 18.3, add support for Layer 2 class of service (CoS).

Additional Information

See the Configuring Localized Data Policy, Forwarding and QoS Overview, and Forwarding and QoS Configuration Examples articles for your software release.

  • Was this article helpful?