Skip to content

Sidebar, header and footer widgets (Widgets, shortcodes and widget areas)

Reign Theme overviewPremiumGet Reign Theme →

Also called: widgets, sidebar widgets, add a widget, header widget, footer widget, widget areas, shortcodes.

Not to be confused with the Side menu (Left panel). Sidebar widgets sit in a column beside your content. The side menu is a strip of menu icons down the edge of the screen.

A widget is a small block of content, such as recent posts. A widget area is a place on your site where widgets go, such as the sidebar or the footer. Reign adds three widgets, four shortcodes and a set of widget areas. A shortcode is a short tag you type into a page, post or text block.

Some items only exist when a plugin is active. The tables below name the plugin for each one. If a widget is missing from the list, activate the plugin it needs.

  1. Go to Appearance > Widgets and open a widget area.
  2. Select the + button and search for the widget name, for example “Reign - News Widget”.
  3. Set the fields shown in the tables below.
  4. Select Update.

Open a page that uses that area. The widget shows there. An area shows on your site only when it holds at least one widget.

Section titled “How do I add something to the sidebar, header or footer?”

Add a widget to the matching widget area, as in the steps above. The sidebar areas are listed under “Widget areas”. The footer is the Footer Widget Area. See also Footer and copyright text.

The Header Widget Area exists only with PeepSo and only on sites that already had widgets in it before 8.1.0. New sites never see it.

These are the widgets Reign adds.

Needs: no plugin.

Shows your latest blog posts as a small list with a thumbnail, the post title and the date. The list is cached for 10 minutes.

Field Default What it does
Title Latest Posts Heading above the list.
Number of posts to show 5 How many posts appear.
Select post category none (all categories) Hold Ctrl or Cmd to pick one or more categories. Leave empty to show every category.

The same list is also a block. In the block editor, search for Reign News Widget (in the Widgets category). It has the same Title (default Latest Posts), Number of posts to show (default 5) and Select post category settings. It also has a Show Author switch, off by default.

Needs: BuddyPress or BuddyBoss Platform.

Shows how complete the logged-in member’s profile is. It lists their photo, the percentage, a progress bar and each part of the profile, with a link to finish it. It shows only to logged-in members, and not while they view someone else’s profile. Place it in any widget area, including the block widget editor (as a Legacy Widget).

Field Default What it does
Title Complete Your Profile Heading above the bar.
Profile field sets none ticked (all) Tick the profile field groups that count toward progress.
Profile photos none ticked (all available) Tick Profile Photo and Cover Photo to count them. A photo type is listed only when members can upload it.
Hide widget once progress hits 100% Off Removes the widget when a member’s profile is complete.

If you tick nothing, Reign counts every profile field group and every photo type that members can upload. On BuddyBoss Platform the percentage comes from BuddyBoss’s own profile progress.

Needs: WooCommerce.

Shows your product categories as image tiles. Empty categories and “Uncategorized” are left out.

Field Default What it does
Title Product Categories Heading above the tiles.
Number of categories per row 3 Tiles per row.
Number of categories 6 Total tiles.
Show parent categories only Off Hides subcategories.
Show product counts On Shows “Items” under the name.
Enable slider Off Turns the row into a slider.
Layout Cards Picks the tile design: Cards, Circles or List (see below).
Selected Categories: (comma-separated IDs) empty (all) Type category IDs such as 12,15,20 to show only those.

Each layout looks different.

  • Cards: category image as the card background, with the name on a solid bar, the product count and a Shop Now button.
  • Circles: a round image, then the Shop Now button, name and count.
  • List: a small image, name, count and the Shop Now button in one row per category.

Widgets saved with the older Layout - 2, 3 or 6 show as Cards, Circles and List. In a footer or sidebar, Cards and Circles flow into a grid sized to the column. Tiles are at least 160px wide. That gives two across in a wide footer column and one across in a narrow sidebar. They ignore Number of categories per row there. The slider, and placing the widget on a page, keep the per-row setting.

Type a shortcode into a Shortcode block, or into any text area. Wrap values in quotes. Leave out an attribute to use its default.

For attributes marked “on or off” below, any text counts as on. To turn one off, set it to 0, for example show_count="0".

Needs: no plugin.

Lists posts in the same card style as your blog archive. Pagination links appear under the list.

Attribute Default Values
category empty (all) Category IDs, comma separated, such as 3,7.
posts_view your blog list layout from the Customizer default-view, wb-grid-view (Grid View) or masonry-view (Masonry View).
posts_per_page the number in Settings > Reading A number.
column_count your Blogs Per Row setting (3) A number of columns for grid and masonry.
[reign_display_posts category="3,7" posts_view="wb-grid-view" posts_per_page="6" column_count="3"]

Needs: WooCommerce.

Shows products using one of Reign’s product card layouts.

Attribute Default Values
layout default default, one, two, three or four.
limit 8 Number of products.
columns 4 Products per row.
category empty (all) A product category slug, such as shoes.
[reign_woo_product_layout layout="two" limit="8" columns="4" category="shoes"]

Needs: WooCommerce.

Shows product category tiles, the same as the Reign - Product Categories widget. On and off values accept true/false, 1/0 or yes/no.

Attribute Default Values
per_row 3 Tiles per row, 1 to 6.
count 6 Total tiles.
show_parent_categories_only off on or off.
show_count on on or off.
enable_slider off on or off.
layout layout-type-1 layout-type-1 (cards), layout-type-4 (circles) or layout-type-5 (list). Older pages that use 2, 3 or 6 show as cards, circles and list.
selected_categories empty (all) Category IDs, comma separated.
show_subcategories off on lists each top-level category that has subcategories, with links to them.
subcat_count 4 Subcategory links per category when show_subcategories is on.
[rg_woo_product_categories per_row="4" count="8" layout="layout-type-5" show_count="0"]
[rg_woo_product_categories show_subcategories="1" subcat_count="5" per_row="3"]

The older [rg_woo_product_category_with_subcategory] shortcode still works on pages that use it. It is the same as show_subcategories="1".

To change the button text, use the widget_rg_woo_product_categories_shop_now_text filter.

Widget areas are the places on your site where widgets can go. Find them in Appearance > Widgets. A widget area shows on your site only when it contains at least one widget.

The Footer Widget Area in the Customizer, holding three widgets

Widget area Where it appears
Right Sidebar The right column on any page whose layout has a right sidebar. This is the default sidebar for every content type.
Left Sidebar The left column on any page whose layout has a left sidebar.
Footer Widget Area The widget row in your site footer.

You can choose a different widget area for a page, post type or search results. See Choose page layouts and sidebars.

These exist when WooCommerce is active.

Widget area Where it appears
WooCommerce Right Sidebar Right column on shop, product, cart, checkout and product category pages, unless you picked another sidebar.
WooCommerce Left Sidebar Left column on those pages.
Shop Filter Panel The filter panel that opens from the shop’s Filter button. Left empty, it shows WooCommerce’s categories, price, rating and attribute filters; add widgets to show your own instead.

These exist when BuddyPress is active.

Widget area Where it appears
Groups Index Sidebar on the groups directory.
Member Index Sidebar on the members directory.
Activity Index Sidebar on the activity directory. It is also used for the documents and media pages and the registration page when they show a sidebar.
Community Directories Left Left column of the members, groups and activity directories when their layout has a left sidebar.
Group Single Sidebar inside a single group.
Member Profile Sidebar on a member’s profile.

Each directory sidebar shows only when the directory’s sidebar layout includes that column. Set it under Reign Settings > Community > Community Settings > Layouts.

While a directory area is empty, Reign fills it with community widgets. These show who is online or recently active, and the groups or latest activity the directory does not list. On BuddyBoss they also show your profile completion and the members you follow. Add any widget or block to the area and only yours show. A page’s own sidebar choice (the page’s Layout box) still wins over these areas.

Developers can change the default widgets with the reign_bp_default_sidebar filter. The column width used with both sidebars (280px) changes with reign_bp_directory_sidebar_width:

add_filter( 'reign_bp_directory_sidebar_width', fn() => '300px' );

These two exist when LearnDash is active and the LearnMate LearnDash add-on is not. Their names use your LearnDash labels. With the default labels they read LD Single Course Sidebar and LD Single Group Sidebar.

Widget area Where it appears
LD Single Course Sidebar A single LearnDash course page.
LD Single Group Sidebar A single LearnDash group page.

Each of these exists while its plugin is active. It shows on that plugin’s pages in place of the main sidebar once it holds a widget. Left empty, the pages use the full width (forum pages use the main sidebar).

Widget area Needs Where it appears
Forums Sidebar bbPress Forum pages: the index, forums, topics, member forum profiles, forum search and views.
PeepSo Sidebar PeepSo Beside PeepSo pages such as Activity, Members and profiles.
LearnDash Sidebar LearnDash Courses, lessons, topics, quizzes and groups.
Events Sidebar The Events Calendar Events, venues and organisers.
Jobs Sidebar WP Job Manager Job listings and resumes.
Header Widget Area PeepSo Replaces the header member menu. It shows only on sites that already had widgets in it before 8.1.0; new sites never see it.

Widget areas not listed here come from other plugins or add-ons, not from the Reign theme. Reign adds no widget areas for Easy Digital Downloads, WC Vendors or FluentCart.