Summery Summery

Register an item.

Syntax Syntax

WP_Dependencies::add( string $handle, string|bool $src, string[] $deps = array(), string|bool|null $ver = false, mixed $args = null )

Description Description

Registers the item if no item of that name already exists.

Parameters Parameters


(string) (Required) Name of the item. Should be unique.


(string|bool) (Required) Full URL of the item, or path of the item relative to the WordPress root directory. If source is set to false, item is an alias of other items it depends on.


(string[]) (Optional) An array of registered item handles this item depends on.

Default value: array()


(string|bool|null) (Optional) String specifying item version number, if it has one, which is added to the URL as a query string for cache busting purposes. If version is set to false, a version number is automatically added equal to current installed WordPress version. If set to null, no version is added.

Default value: false


(mixed) (Optional) Custom property of the item. NOT the class property $args. Examples: $media, $in_footer.

Default value: null

Return Return

(bool) Whether the item has been registered. True on success, false on failure.

Source Source

File: wp-includes/class.wp-dependencies.php

	 *                                 Examples: $media, $in_footer.
	 * @return bool Whether the item has been registered. True on success, false on failure.
	public function add( $handle, $src, $deps = array(), $ver = false, $args = null ) {
		if ( isset( $this->registered[ $handle ] ) ) {
			return false;


Changelog Changelog

Version Description
2.6.0 Moved from WP_Scripts.
2.1.0 Introduced.


Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.