Sidebar, header and footer widgets (Widgets, shortcodes and widget areas)
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.
What this does
Section titled “What this does”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.
- Go to Appearance > Widgets and open a widget area.
- Select the + button and search for the widget name, for example “Reign - News Widget”.
- Set the fields shown in the tables below.
- Select Update.
You’ll know it worked when
Section titled “You’ll know it worked when”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.
Good to know
Section titled “Good to know”How do I add something to the sidebar, header or footer?
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.
How do I configure the header widget?
Section titled “How do I configure the header widget?”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.
Widgets
Section titled “Widgets”These are the widgets Reign adds.
Reign - News Widget
Section titled “Reign - News Widget”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.
Reign - Profile Completion
Section titled “Reign - Profile Completion”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.
Reign - Product Categories
Section titled “Reign - Product Categories”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.
Shortcodes
Section titled “Shortcodes”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".
reign_display_posts
Section titled “reign_display_posts”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"]reign_woo_product_layout
Section titled “reign_woo_product_layout”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"]rg_woo_product_categories
Section titled “rg_woo_product_categories”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
Section titled “Widget areas”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.
Always available
Section titled “Always available”
| 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.
WooCommerce
Section titled “WooCommerce”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. |
BuddyPress
Section titled “BuddyPress”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' );Learning
Section titled “Learning”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. |
Plugin pages
Section titled “Plugin pages”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.

