Widgets
Widgets are pieces of content that can be added to specific areas of your site, such as the sidebar or footer.
While previously limited to adding a specific list of widgets to your site via Appearance → Customize → Widgets, you may now add any block to your site’s widget areas too. This greatly enhances how you can customize the widget areas of your site.
Any existing widgets you’ve added to your site will still work as normal and will not be affected by adding blocks.
How To Add Widgets
Visit Appearance → Customize → Widgets to view the available widget areas of your theme. The most common widget areas are the footer and sidebar, but you may see others depending on the theme you are using:

Click either of the + block inserter buttons to add a widget.
To view the complete list of blocks you can add, click Browse all. You may use the search box at the top to find a block easily, or scroll down to browse all the blocks by category.
The legacy widgets from before the introduction of blocks are listed under the ‘Widgets’ category and are still available to add.
Click any block to add it to your widget area and click Save Changes when you’re ready to save your changes to the site.

Block Widget Options
After adding a block, click on it once and a toolbar will appear with several options specific to that block. For even more options, click the … (three dots) to choose from:
- Show more settings: Access additional settings specific to that block.
- Copy: Copy the block to later paste it somewhere else.
- Duplicate: Make a duplicate of the block appear immediately below the one you’re working on.
- Insert before: Insert a new block immediately before the block you’re working on.
- Insert after: Insert a new block immediately after the block you’re working on.
- Move to: Move the block to a specific point in that widget area.
- Group: Add the block to a Group block.
- Remove block: Delete the block from your widget area.
Move Blocks Between Widget Areas
If you added a widget to one area, but later decide to move it to a different area, follow these steps:
- Click on the block.
- In the toolbar that appears, click the Move to widget area icon (it looks like a squiggly arrow.)
- Select the widget area to move the block to.

Remove a Widget
To remove a block you have added to a widget area, click on the block once and select the … (three dots) in the toolbar. Then, click Remove Block:

Widget Visibility
You can set widgets to appear only on certain pages, or to be hidden on certain pages.
To access the Visibility settings for block widgets:
- Select the block widget.
- Click on the … (three dots) on the right side of the block widget toolbar and select Show more settings.
- Under Block Settings, expand the Advanced tab and click Add new rule under “Visibility,” as shown below.

You can access the Visibility settings for legacy widgets by clicking the Visibility button at the bottom of the widget.
Visibility Settings
Visibility is controlled by six aspects: page type, category, tag, date, author, and taxonomy. For example, if you want the Archives widget to only appear on category archives and error pages, choose Show from the first dropdown and then add the rules “Page is 404 Error Page” and “Category is All Category Pages,” as shown here:

You can also hide widgets based on the current page. For example, if you don’t want the Archives widget to appear on search results pages, choose Hide and add the rule “Page is Search Results” like this:

If you have multiple visibility rules, you can choose whether visibility rules are handled separately or simultaneously by toggling Match all rules in block widgets, or Match all conditions in legacy widgets. For example, you can display a widget only on posts that are categorized as “Summer” and also tagged with “Picnic” by setting the visibility conditions to match the rules for the category and the tag. If Match all rules (or conditions) is on, all rules must be passed (“AND”) to hide or display the widget, while if it’s off, any rule matching (“OR”) will fulfill the conditions.


Next page: Classic Widgets.
Still confused?
Help us improve:
We're always looking to improve our documentation. If this page didn't answer your question or left you wanting more, let us know! We love hearing your feedback. For support, please use the forums or contact support form. Thanks!