Codex

Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

Design Widgets SubPanel

wp-alert.png
This article may be outdated and contain information pertaining to an older version of WordPress. Please take caution when following the procedure, as many things may have changed.

Themes usually have at least 1 or 2 sidebars. Sidebars are the narrow columns to the left or right of your blog posts. You can configure your sidebar by going to Appearance > Widgets. Each section in the sidebar is known as a "widget" that you can add or remove, and move up or down.

Configuring Your Widgets

To configure your sidebar widgets:

  1. Click Appearance in the administrator's menu, and then click Widgets. The Widgets subtab has two sections: Available Widgets and Current Widgets.
  2. In the Current Widgets section, select which sidebar you want to show/configure. Note: The default Kubrick theme has just one sidebar defined. Other themes might have more than one sidebar defined, and if so, you'll be able to select it from the Current Widgets drop-down box.
  3. Click the Add button next to a widget in the Available Widgets column to add the widget to that sidebar.
  4. In the Current Widgets section, drag and drop the widgets in the order you want.
  5. Click the Edit link on the widget to set any additional details, such as the title and number of items displayed. Each of the available widgets is described below.
  6. Click the Save Changes button.

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.
  • No configuration items.
Meta - displays links to meta functions such as 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 1 - displays an RSS Feed. 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.
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.
Text 1 - used to enter HTML, Javascript, or just plain text. 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 click the widget's Add link as many times as you need the widget.

You can see any unused widgets by making a selection in the drop-down filter below the Available Widgets column.

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".

Back to Administration Panels.