Summery Summery

Adds a rewrite rule that transforms a URL structure to a set of query vars.

Syntax Syntax

add_rewrite_rule( string $regex, string|array $query, string $after = 'bottom' )

Description Description

Any value in the $after parameter that isn’t ‘bottom’ will result in the rule being placed at the top of the rewrite rules.

Parameters Parameters


(Required) Regular expression to match request against.


(Required) The corresponding query vars for this rewrite rule.


(Optional) Priority of the new rule. Accepts 'top' or 'bottom'. Default 'bottom'.

Default value: 'bottom'

Source Source

File: wp-includes/rewrite.php

function add_rewrite_rule( $regex, $query, $after = 'bottom' ) {
	global $wp_rewrite;

	$wp_rewrite->add_rule( $regex, $query, $after );


Changelog Changelog

Version Description
4.4.0 Array support was added to the $query parameter.
2.1.0 Introduced.


Leave a Reply