Summery Summery

Adds multiple links to the response.

Syntax Syntax

WP_REST_Response::add_links( array $links )

Description Description

Link data should be an associative array with link relation as the key. The value can either be an associative array of link attributes (including href with the URL for the response), or a list of these associative arrays.

Parameters Parameters


(Required) Map of link relation to list of links.

Source Source

File: wp-includes/rest-api/class-wp-rest-response.php

	public function add_links( $links ) {
		foreach ( $links as $rel => $set ) {
			// If it's a single link, wrap with an array for consistent handling.
			if ( isset( $set['href'] ) ) {
				$set = array( $set );

			foreach ( $set as $attributes ) {
				$this->add_link( $rel, $attributes['href'], $attributes );


Changelog Changelog

Version Description
4.4.0 Introduced.


Leave a Reply