Setup & site building · Guide
How to Add Widget in WordPress (Step by Step)

Short answer
To add a widget in WordPress, go to Appearance > Widgets, open a widget area like the sidebar or footer, click the + inserter, pick a block such as Search or Latest Posts, and click Update. If your theme is a block theme, there is no Widgets screen, so add blocks to a template part in Appearance > Editor.
Key takeaways
- Classic themes use Appearance > Widgets or the Customizer to add widgets.
- Since WordPress 5.8, widgets are blocks, and old widgets use the Legacy Widget block.
- The Classic Widgets plugin brings back the old drag-and-drop screen.
- Block themes have no widget areas, so use the Site Editor instead.
- If a widget does not show, check the template, saved changes and cache.
How do you add a widget in WordPress?
In a classic theme, go to Appearance > Widgets, open a widget area, click the + inserter, choose a block and click Update; block themes use Appearance > Editor instead.
Widgets are small blocks of content that sit outside your main posts and pages. Common examples are a search box, recent posts, a newsletter form or a short About blurb in the sidebar.
How you add them depends on your theme. This guide covers the block-based widget screen, the Customizer, the old classic widgets screen, and block themes that have no widget screen at all.
What do you need to know before adding widgets?
Before adding widgets, check whether your theme is a classic theme with widget areas or a block theme, because block themes do not have a Widgets screen and use the Site Editor instead.
Look in the Appearance menu:
- If you see Widgets and Customize, you have a classic theme with widget areas.
- If you see Editor and no Widgets item, you have a block theme.
Our comparison of block themes vs classic themes explains the difference.
If you are unsure what counts as a widget, start with our explainer on what a widget is.
You also need an Administrator account, since only admins can change widgets by default.
How do you add a widget with the block widget editor?
Open Appearance > Widgets, expand the widget area you want, click the blue + button, search for the block you need, add it, set its options and click Update to publish it.
Since WordPress 5.8, the Widgets screen uses blocks, as announced in the WordPress 5.8 widgets editor dev note. The Block-based Widgets Editor documentation on WordPress.org shows the screen in detail.
Step by step:
- In the dashboard, go to Appearance > Widgets.
- Click the name of a widget area, such as Sidebar or Footer 1, to expand it.
- Click the + inserter inside that area.
- Search for a block, such as Search, Latest Posts or Image.
- Click the block to add it.
- Adjust its settings in the right-hand panel.
- Click Update at the top right.
Visit your site to check the result. Widget areas only show on templates where the theme displays them. A sidebar might appear on posts but not on pages.
Which widgets can you add?
You can add any WordPress block as a widget, including Search, Latest Posts, Categories, Archives, Image, Paragraph, Custom HTML and Navigation, plus older widgets from plugins through the Legacy Widget block.
Popular choices for a sidebar:
- Search so readers can find posts.
- Latest Posts or Latest Comments for fresh content.
- Categories or Tag Cloud to help people browse.
- Image with a link for a banner or promo.
- Custom HTML for small embed codes.
Plugins that still use old-style widgets appear through the Legacy Widget block. The Legacy Widget block guide on the developer site explains how this works.
Group related blocks with the Group block so you can give them one heading and one background.
How do you add widgets with the Customizer?
Go to Appearance > Customize, open the Widgets panel, pick a widget area, add a block, and watch the live preview update before clicking Publish.
The Customizer is helpful because you see the change on your site as you make it. Steps:
- Go to Appearance > Customize.
- Click Widgets.
- Choose the widget area.
- Click the + button and pick a block.
- Edit the block and check the live preview.
- Click Publish.
You can also navigate to a different page in the preview first. That lets you see widget areas that only show on certain templates.
How do you get the old classic widgets screen back?
Install and activate the official Classic Widgets plugin, which restores the older drag-and-drop widget screen and turns off the block-based widget editor.
Some people prefer the classic screen, and some older themes and plugins work better with it. The Classic Widgets plugin is maintained by WordPress contributors.
After activating it, go to Appearance > Widgets. You can drag a widget from the list on the left into a widget area on the right, fill in its fields and click Save.
You can switch back to blocks any time by deactivating the plugin. Your widgets usually carry over, but check each area afterwards.
How do you add widgets in a block theme?
Block themes have no widget areas, so you open Appearance > Editor, edit the template or template part where the widget should go, such as the footer, and add blocks there directly.
Step by step:
- Go to Appearance > Editor.
- Open Patterns and pick the Footer or Header template part, or open Templates and choose a template like Single Posts.
- Click the + inserter where you want the content.
- Add blocks such as Search, Latest Posts or Social Icons.
- Click Save.
To add a sidebar, use a Columns block in the template, with the main content in one column and your widget-style blocks in the other.
Our guide on editing the header in a block theme walks through the Site Editor in more depth. The Learn WordPress widget tutorial is also useful for the classic side.
Widget methods compared
Each way of adding widgets suits a different theme type and working style.
| Method | Theme type | Where | Best for |
|---|---|---|---|
| Block widget editor | Classic | Appearance > Widgets | Most classic theme users |
| Customizer | Classic | Appearance > Customize > Widgets | Seeing changes live |
| Classic Widgets plugin | Classic | Appearance > Widgets | Drag and drop, older plugins |
| Site Editor | Block | Appearance > Editor | Block themes like Twenty Twenty-Five |
| Page builder widgets | Any with builder | Elementor or similar | Builder-made layouts |
How do you add a widget area that your theme lacks?
If your classic theme has no sidebar or footer widget area where you want one, a developer can register a new area with register_sidebar in a child theme and output it in a template file.
The function is documented in the register_sidebar reference. You register the area, then call dynamic_sidebar in the template where it should appear.
Our guide on adding a custom widget area gives the full code and steps.
Always do this in a child theme so theme updates do not erase your work.
How do you move, hide or remove a widget?
Select the widget block, then use the up and down arrows in its toolbar to move it, the three-dot menu to remove it, or drag it into another widget area in the list view.
To move a widget between areas, open the List View at the top of the Widgets screen and drag the block from one area to another.
To hide a widget temporarily, the classic screen has an Inactive Widgets area. On the block screen, you can move blocks into the Inactive widgets area if your theme shows one, or simply remove the block.
To show widgets only on some pages, you need a plugin that adds visibility rules. Several free options are available in the plugin directory.
Why is your new widget not showing?
A new widget usually does not show because the theme hides that widget area on the page you are viewing, the change was not saved, or a cache is serving an old page.
Check these:
- Right template. Some sidebars show only on posts, not pages or the home page.
- Saved changes. Click Update and reload the widget screen to confirm.
- Cache. Clear your cache plugin and CDN.
- Theme options. Some themes let you turn the sidebar off per page or layout.
For a full checklist, see our guide on fixing widgets not showing.
What are good habits when using widgets?
Keep widgets few and useful, because a cluttered sidebar slows pages and distracts readers, and review them every few months to remove anything outdated.
A sidebar with a search box, a short bio and a few popular posts often works better than ten different widgets.
Watch out for widgets that load outside scripts, such as social feeds. They can slow your site on every page where the widget appears.
If you want to reuse the same block group in several places, save it as a synced pattern. Our guide on synced patterns shows how.
Frequently asked questions
Why is there no Widgets option in my Appearance menu?
You are most likely using a block theme, which has no widget areas. Use Appearance and then Editor to add blocks to templates and template parts such as the header or footer instead.
Can I add any block as a widget?
Yes, the block-based widget editor accepts almost any block, including Paragraph, Image, Search and Latest Posts. A few blocks meant only for full templates may not be available in widget areas.
How do I add a widget to my WordPress footer?
In a classic theme, open Appearance and Widgets and expand a footer widget area, if your theme has one. In a block theme, edit the Footer template part in the Site Editor and add blocks there.
Do plugins add their own widgets?
Many do. Newer plugins usually add blocks you can insert in any widget area, while older ones add classic widgets that appear inside the Legacy Widget block.
Will switching themes remove my widgets?
Widgets are tied to the theme's widget areas. When you switch themes, WordPress tries to map them to the new theme's areas, but some may end up inactive, so check the Widgets screen after a switch.
Sources
- Block-based Widgets Editor WordPress.org
- About the Legacy Widget block WordPress Developer Resources
- Using the Block Widget Editor Learn WordPress
- Classic Widgets plugin WordPress.org
- register_sidebar() WordPress Developer Resources
Is your product missing, or something out of date?
Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.
Thanks — we review requests within 3 business days.
Related guides
About the editors
Researched from the primary sources listed above and checked against our editorial rules before publishing.


