WordPress at a glance

unregister_widget() WP 1.0

Unregisters a widget.

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

No Hooks.


null. Nothing.


unregister_widget( $widget );
$widget(string|WP_Widget) (required)
Either the name of a WP_Widget subclass or an instance of a WP_Widget subclass.


  • See: WP_Widget
  • Global. WP_Widget_Factory. $wp_widget_factory


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

Code of unregister_widget() WP 5.7.2

function unregister_widget( $widget ) {
	global $wp_widget_factory;

	$wp_widget_factory->unregister( $widget );

From tag: Sidebar (widgets)

No comments
    Log In