Title: delete_widget
Published: December 9, 2015
Last modified: February 24, 2026

---

# do_action( ‘delete_widget’, string $widget_id, string $sidebar_id, string $id_base )

## In this article

 * [Parameters](https://developer.wordpress.org/reference/hooks/delete_widget/?output_format=md#parameters)
 * [Source](https://developer.wordpress.org/reference/hooks/delete_widget/?output_format=md#source)
 * [Related](https://developer.wordpress.org/reference/hooks/delete_widget/?output_format=md#related)
 * [Changelog](https://developer.wordpress.org/reference/hooks/delete_widget/?output_format=md#changelog)

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

Fires immediately after a widget has been marked for deletion.

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

 `$widget_id`string

ID of the widget marked for deletion.

`$sidebar_id`string

ID of the sidebar the widget was deleted from.

`$id_base`string

ID base for the widget.

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

    ```php
    do_action( 'delete_widget', $widget_id, $sidebar_id, $id_base );
    ```

[View all references](https://developer.wordpress.org/reference/files/wp-admin/widgets-form.php/)
[View on Trac](https://core.trac.wordpress.org/browser/tags/6.9.4/src/wp-admin/widgets-form.php#L169)
[View on GitHub](https://github.com/WordPress/wordpress-develop/blob/6.9.4/src/wp-admin/widgets-form.php#L169-L169)

## 󠀁[Related](https://developer.wordpress.org/reference/hooks/delete_widget/?output_format=md#related)󠁿

| Used by | Description | 
| [WP_REST_Widgets_Controller::delete_item()](https://developer.wordpress.org/reference/classes/wp_rest_widgets_controller/delete_item/)`wp-includes/rest-api/endpoints/class-wp-rest-widgets-controller.php` |

Deletes a widget.

  | 
| [wp_ajax_save_widget()](https://developer.wordpress.org/reference/functions/wp_ajax_save_widget/)`wp-admin/includes/ajax-actions.php` |

Handles saving a widget via AJAX.

  |

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

| Version | Description | 
| [4.4.0](https://developer.wordpress.org/reference/since/4.4.0/) | Introduced. |

## User Contributed Notes

You must [log in](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Fhooks%2Fdelete_widget%2F)
before being able to contribute a note or feedback.