Directory

wp widget – WP-CLI Command | Developer.WordPress.org

wp widget <command>

Manages widgets, including adding and moving them within sidebars.

In this article

A widget adds content and features to a widget area (also called a sidebar).

Examples

# List widgets on a given sidebar
$ wp widget list sidebar-1
+----------+------------+----------+----------------------+
| name     | id         | position | options              |
+----------+------------+----------+----------------------+
| meta     | meta-6     | 1        | {"title":"Meta"}     |
| calendar | calendar-2 | 2        | {"title":"Calendar"} |
+----------+------------+----------+----------------------+

# Add a calendar widget to the second position on the sidebar
$ wp widget add calendar sidebar-1 2
Success: Added widget to sidebar.

# Update option(s) associated with a given widget
$ wp widget update calendar-1 --title="Calendar"
Success: Widget updated.

# Delete one or more widgets entirely
$ wp widget delete calendar-2 archive-1
Success: 2 widgets removed from sidebar.

Subcommands

NameDescription
wp widget add

Adds a widget to a sidebar.

wp widget deactivate

Deactivates one or more widgets from an active sidebar.

wp widget delete

Deletes one or more widgets from a sidebar.

wp widget list

Lists widgets associated with a sidebar.

wp widget move

Moves the position of a widget.

wp widget reset

Resets sidebar.

wp widget update

Updates options for an existing widget.

Command documentation is regenerated at every release. To add or update an example, please submit a pull request against the corresponding part of the codebase.