Title: WP_Dependencies::dequeue
Published: April 25, 2014
Last modified: February 24, 2026

---

# WP_Dependencies::dequeue( string|string[] $handles )

## In this article

 * [Description](https://developer.wordpress.org/reference/classes/WP_Dependencies/dequeue/?output_format=md#description)
 * [Parameters](https://developer.wordpress.org/reference/classes/WP_Dependencies/dequeue/?output_format=md#parameters)
 * [Source](https://developer.wordpress.org/reference/classes/WP_Dependencies/dequeue/?output_format=md#source)
 * [Changelog](https://developer.wordpress.org/reference/classes/WP_Dependencies/dequeue/?output_format=md#changelog)

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

Dequeue an item or items.

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

Decodes handles and arguments, then dequeues handles and removes arguments from 
the class property $args.

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

 `$handles`string|string[]required

Item handle (string) or item handles (array of strings).

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

    ```php
    public function dequeue( $handles ) {
    	foreach ( (array) $handles as $handle ) {
    		$handle = explode( '?', $handle );
    		$key    = array_search( $handle[0], $this->queue, true );

    		if ( false !== $key ) {
    			// Reset all dependencies so they must be recalculated in recurse_deps().
    			$this->all_queued_deps = null;

    			unset( $this->queue[ $key ] );
    			unset( $this->args[ $handle[0] ] );
    		} elseif ( array_key_exists( $handle[0], $this->queued_before_register ) ) {
    			unset( $this->queued_before_register[ $handle[0] ] );
    		}
    	}
    }
    ```

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

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

| Version | Description | 
| [2.6.0](https://developer.wordpress.org/reference/since/2.6.0/) | Moved from `WP_Scripts`. | 
| [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_dependencies%2Fdequeue%2F)
before being able to contribute a note or feedback.