WordPress.org

Ready to get started?Download WordPress

Codex

Appearance Widgets Screen

Contents

Appearance → Widgets

Themes usually have at least 1 or 2 sidebars. Sidebars are the narrow columns to the left or right of your blog posts. Each section in the sidebar is known as a "Widget" that you can add or remove, and move up or down. You configure Widgets in your sidebar by via the Appearance Widgets Screen. Some themes also are configured to accept widgets in certain parts of the footer.

Appearance Widgets Screen


Back to Administration Screens

Configuring Your Widgets

  1. Click on Appearance > Widgets from the main navigation menu in your Dashboard.
  2. Add new widgets from the Available Widgets section by dragging them to the Sidebar you want to customize. (There might be more than one sidebar option, depending on your theme.)
  3. Preview your site and you should see the content from your new Widget.
  4. Return to the Widgets Panel to continue adding Widgets to the Sidebar as needed.
  5. To arrange the Widgets within the Sidebar, click, drag and drop the widgets in the order you want.
  6. To customize the Widget features, click the down arrow (or edit link) in the upper right corner to expand the Widget's interface.
  7. To save the Widget's customization, click Save. (If simply moving a widget to the sidebar without making customizations, you do not need to click the Save button.)
  8. Preview your site again, and all of your changes should be visible.

Remove a Widget

  1. Click on Appearance > Widgets from the main navigation menu in your Dashboard.
  2. Decide which Sidebar from which you want to remove your widget if there is more than one option.
  3. For the Widget that is to be removed, click the down arrow (or edit link) in the upper right corner to expand the Widget's interface
  4. Click the Delete link in the dialog box.
  5. The Widget will now be removed permanently.
  6. Preview your site to see your changes.

Note: If you would like to remove a widget temporarily and keep your settings, drag the widget from the Sidebar into the Inactive Widgets section. When you are ready to return the widget, drag it from your Inactive Widgets section back to the Sidebar.

Moving a Widget

To move a Widget:

  1. The Widget must be located in a Sidebar or other active content area before it can be moved.
  2. Click on the Widget Title and hold the mouse button down, then drag the Widget bar up or down to the location desired. At that point release the mouse button. That process is called drag-and-drop.

Descriptions of Each Widget

Here's a description of the various types of widget along with their configuration options:

Archives - displays archive links for each month that has posts.
  • Title — description that appears over the list of archive links.
  • Show post counts — if checked, this box causes a count of the number of posts for each archive period.
  • Display as a drop down — if checked, this box causes the archives to be displayed in a drop-down box.
Calendar - displays a calendar of the current month. Dates appear links if there are posts for that day.
  • Title — description that appears over the calendar
Categories - displays a list of post categories as links to those posts.
  • Title — description that appears over the list of categories.
  • Show as dropdown — if checked, this box causes the categories to be displayed in a dropdown box.
  • Show post counts — if checked, this box causes the count of the number of posts to display with each category.
  • Show hierarchy — if checked, shows parent/child relationships in an indented manner.
Links - displays list of links (blogroll) separated by category. NOT EXISTS IN V3.8
  • No configuration items.
Meta - displays links to meta functions such as Register, Site Admin, Login/out, Entries RSS, Comments RSS, and WordPress.org.
  • Title — description that appears over the list of meta links.
Pages - displays a link to each Page.
  • Title — description that appears over the list of pages.
  • Sort by — select the order to sort the list of pages. Choose Page Title, Page Order, or Page ID from pulldown box (this was added at 2.2.1)
  • Exclude (Page IDs, separated by commas) — enter the Page ID(s) to exclude, separating each Page ID with a commaa (this was added at 2.2.1)
Recent Comments - displays a list of the blog's most recent approved comments.
  • Title — description that appears over the list of recent comments.
  • Number of comments to show: (at most 15); enter the number of comments to be displayed.
Recent Posts - displays list of the blog's most recent posts.
  • Title — description that appears over the list of recent posts.
  • Number of posts to show: (at most 15) — enter the number of posts to display.
RSS - displays an RSS Feed. Multiple instances of this widget can be added to the Current Widgets list. Using RSS Widgets lists several feeds to use with this widget.
  • Enter the RSS feed URL here — enter a complete feed URL, e.g. http://wordpress.org/development/feed/
  • Give the feed a title (optional) — enter a description that appears over the list of feed items
  • How many items would you like to display — enter the number of items from the feed you want displayed.
  • Display item content?— check this to display the content of the feed
  • Display item author if available — check this to display the author of this particular item content
  • Display item date — check this to display the date the item was published
Search - displays a Search box to enter text to search your blog. A submit button is also provided.
  • No configuration items.
Tag Cloud - displays list of the blog's top 45 used tags in a tag cloud.
  • Title — description that appears over the tag cloud.
  • Taxonomy — select the desired registered taxonomy (e.g. Post Tag, Category).
Text - used to enter HTML, Javascript, or just plain text. Multiple instances of this widget can be added to the Current Widgets list. Using Text Widgets details a number of possible uses for text widgets.
  • Title area — a description of the text widget
  • Text area — use this area to enter text, valid HTML, or even valid Javascript.

Adding Multiple Widgets of the Same Kind

To add multiple text widgets, RSS widgets, or any other widgets, just drag and drop the widget from Available Widgets to your Sidebar as many times as you need.

No Sidebars Defined

If the current active Theme is not widget compatible, meaning the theme is not coded for widgets, you will see the message, "You are seeing this message because the theme you are currently using isn’t widget-aware, meaning that it has no sidebars that you are able to change. For information on making your theme widget-aware, please follow these instructions".

See also Administration Screens and Network Admin.