Schema
The schema defines all the fields that exist within a widget record. Any response from these endpoints can be expected to contain the fields below unless the `_filter` query parameter is used or the schema field only appears in a specific context.
id | Unique identifier for the widget. JSON data type: string Context: |
id_base | The type of the widget. Corresponds to ID in widget-types endpoint. JSON data type: string Context: |
sidebar | The sidebar the widget belongs to. JSON data type: string Context: |
rendered | HTML representation of the widget. JSON data type: string Read only Context: |
rendered_form | HTML representation of the widget admin form. JSON data type: string Read only Context: |
instance | Instance settings of the widget, if supported. JSON data type: object Context: |
form_data | URL-encoded form data from the widget admin form. Used to update a widget that does not support instance. Write only. JSON data type: string Context: |
Retrieve a Widget
Definition & Example Request
GET /wp/v2/widgets
Query this endpoint to retrieve a specific widget record.
$ curl https://example.com/wp-json/wp/v2/widgets
Arguments
context | Scope under which the request is made; determines fields present in response. Default: One of: |
sidebar | The sidebar to return widgets for. |
Create a Widget
Arguments
id | Unique identifier for the widget. |
id_base | The type of the widget. Corresponds to ID in widget-types endpoint. |
sidebar | The sidebar the widget belongs to. Required: 1 Default: |
instance | Instance settings of the widget, if supported. |
form_data | URL-encoded form data from the widget admin form. Used to update a widget that does not support instance. Write only. |
Definition
POST /wp/v2/widgets
Retrieve a Widget
Definition & Example Request
GET /wp/v2/widgets/<id>
Query this endpoint to retrieve a specific widget record.
$ curl https://example.com/wp-json/wp/v2/widgets/<id>
Arguments
context | Scope under which the request is made; determines fields present in response. Default: One of: |
Update a Widget
Arguments
id | Unique identifier for the widget. |
id_base | The type of the widget. Corresponds to ID in widget-types endpoint. |
sidebar | The sidebar the widget belongs to. |
instance | Instance settings of the widget, if supported. |
form_data | URL-encoded form data from the widget admin form. Used to update a widget that does not support instance. Write only. |
Delete a Widget
Arguments
force | Whether to force removal of the widget, or move it to the inactive sidebar. |
Definition
DELETE /wp/v2/widgets/<id>
Example Request
$ curl -X DELETE https://example.com/wp-json/wp/v2/widgets/<id>