Title: WP_Rewrite::add_endpoint
Published: April 25, 2014
Last modified: April 28, 2025

---

# WP_Rewrite::add_endpoint( string $name, int $places, string|bool $query_var = true )

## In this article

 * [Description](https://developer.wordpress.org/reference/classes/wp_rewrite/add_endpoint/?output_format=md#description)
    - [See also](https://developer.wordpress.org/reference/classes/wp_rewrite/add_endpoint/?output_format=md#see-also)
 * [Parameters](https://developer.wordpress.org/reference/classes/wp_rewrite/add_endpoint/?output_format=md#parameters)
 * [Source](https://developer.wordpress.org/reference/classes/wp_rewrite/add_endpoint/?output_format=md#source)
 * [Related](https://developer.wordpress.org/reference/classes/wp_rewrite/add_endpoint/?output_format=md#related)
 * [Changelog](https://developer.wordpress.org/reference/classes/wp_rewrite/add_endpoint/?output_format=md#changelog)

[ Back to top](https://developer.wordpress.org/reference/classes/wp_rewrite/add_endpoint/?output_format=md#wp--skip-link--target)

Adds an endpoint, like /trackback/.

## 󠀁[Description](https://developer.wordpress.org/reference/classes/wp_rewrite/add_endpoint/?output_format=md#description)󠁿

### 󠀁[See also](https://developer.wordpress.org/reference/classes/wp_rewrite/add_endpoint/?output_format=md#see-also)󠁿

 * [add_rewrite_endpoint()](https://developer.wordpress.org/reference/functions/add_rewrite_endpoint/):
   for full documentation.

## 󠀁[Parameters](https://developer.wordpress.org/reference/classes/wp_rewrite/add_endpoint/?output_format=md#parameters)󠁿

 `$name`stringrequired

Name of the endpoint.

`$places`intrequired

Endpoint mask describing the places the endpoint should be added.
 Accepts a mask
of:

 * `EP_ALL`
 * `EP_NONE`
 * `EP_ALL_ARCHIVES`
 * `EP_ATTACHMENT`
 * `EP_AUTHORS`
 * `EP_CATEGORIES`
 * `EP_COMMENTS`
 * `EP_DATE`
 * `EP_DAY`
 * `EP_MONTH`
 * `EP_PAGES`
 * `EP_PERMALINK`
 * `EP_ROOT`
 * `EP_SEARCH`
 * `EP_TAGS`
 * `EP_YEAR`

`$query_var`string|booloptional

Name of the corresponding query variable. Pass `false` to skip registering a query_var
for this endpoint. Defaults to the value of `$name`.

Default:`true`

## 󠀁[Source](https://developer.wordpress.org/reference/classes/wp_rewrite/add_endpoint/?output_format=md#source)󠁿

    ```php
    public function add_endpoint( $name, $places, $query_var = true ) {
    	global $wp;

    	// For backward compatibility, if null has explicitly been passed as `$query_var`, assume `true`.
    	if ( true === $query_var || null === $query_var ) {
    		$query_var = $name;
    	}
    	$this->endpoints[] = array( $places, $name, $query_var );

    	if ( $query_var ) {
    		$wp->add_query_var( $query_var );
    	}
    }
    ```

[View all references](https://developer.wordpress.org/reference/files/wp-includes/class-wp-rewrite.php/)
[View on Trac](https://core.trac.wordpress.org/browser/tags/6.9.4/src/wp-includes/class-wp-rewrite.php#L1752)
[View on GitHub](https://github.com/WordPress/wordpress-develop/blob/6.9.4/src/wp-includes/class-wp-rewrite.php#L1752-L1764)

## 󠀁[Related](https://developer.wordpress.org/reference/classes/wp_rewrite/add_endpoint/?output_format=md#related)󠁿

| Uses | Description | 
| [WP::add_query_var()](https://developer.wordpress.org/reference/classes/wp/add_query_var/)`wp-includes/class-wp.php` |

Adds a query variable to the list of public query variables.

  |

| Used by | Description | 
| [add_rewrite_endpoint()](https://developer.wordpress.org/reference/functions/add_rewrite_endpoint/)`wp-includes/rewrite.php` |

Adds an endpoint, like /trackback/.

  |

## 󠀁[Changelog](https://developer.wordpress.org/reference/classes/wp_rewrite/add_endpoint/?output_format=md#changelog)󠁿

| Version | Description | 
| [4.3.0](https://developer.wordpress.org/reference/since/4.3.0/) | Added support for skipping query var registration by passing `false` to `$query_var`. | 
| [3.9.0](https://developer.wordpress.org/reference/since/3.9.0/) | $query_var parameter added. | 
| [2.1.0](https://developer.wordpress.org/reference/since/2.1.0/) | Introduced. |

## User Contributed Notes

You must [log in](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Fclasses%2Fwp_rewrite%2Fadd_endpoint%2F)
before being able to contribute a note or feedback.