unregister_widget( string|WP_Widget $widget )

Unregisters a widget.

Description Description

Unregisters a WP_Widget widget. Useful for un-registering default widgets. Run within a function hooked to the ‘widgets_init’ action.

See also See also

Top ↑

Parameters Parameters


(string|WP_Widget) (Required) Either the name of a WP_Widget subclass or an instance of a WP_Widget subclass.

Top ↑

Source Source

File: wp-includes/widgets.php

function unregister_widget( $widget ) {
	global $wp_widget_factory;

	$wp_widget_factory->unregister( $widget );

Top ↑

Changelog Changelog

Version Description
4.6.0 Updated the $widget parameter to also accept a WP_Widget instance object instead of simply a WP_Widget subclass name.
2.8.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

  1. Skip to note 2 content
    Contributed by jdnn

    Available parameters (from the Codex):

    WP_Widget_Pages = Pages Widget
    WP_Widget_Calendar = Calendar Widget
    WP_Widget_Archives = Archives Widget
    WP_Widget_Links = Links Widget
    WP_Widget_Meta = Meta Widget
    WP_Widget_Search = Search Widget
    WP_Widget_Text = Text Widget
    WP_Widget_Categories = Categories Widget
    WP_Widget_Recent_Posts = Recent Posts Widget
    WP_Widget_Recent_Comments = Recent Comments Widget
    WP_Widget_RSS = RSS Widget
    WP_Widget_Tag_Cloud = Tag Cloud Widget
    WP_Nav_Menu_Widget = Menus Widget

You must log in before being able to contribute a note or feedback.