Widgets & Sidebars in PolyCMS

Last updated on May 16, 2026 3:06 AM

Widget System Overview

Widgets are modular content blocks that can be placed in theme-defined Widget Areas (sidebars, footer zones, etc.). PolyCMS ships with 9 built-in widgets ready for immediate use.

Built-in Widgets

WidgetDescription
Latest PostsDisplays recent blog posts with configurable count
Popular PostsShows most-viewed posts based on view tracking
CategoriesLists all categories with post counts
Tags CloudVisual tag cloud with weighted sizing
SearchFrontend search form for blog content
Recent CommentsLatest approved comments with excerpts
ArchivesMonthly/yearly post archives
Custom HTMLFreeform HTML content block
Social LinksSocial media profile links with icons

Configuring Widgets

Navigate to Blog > Widgets to manage widget placement:

  1. Select a Widget Area — Choose from available areas defined by your active theme (e.g., "Blog Sidebar", "Footer Column 1").
  2. Add Widgets — Drag widgets from the available list into the target area.
  3. Configure — Click each widget to expand settings:
  • Widget title (displayed as heading above widget content)
  • Widget-specific options (e.g., number of posts to show, category to filter)
  1. Reorder — Drag widgets within an area to change display order.
  2. Save — Click Save to apply changes.

Widget Areas

Widget Areas are defined by your active theme. The default Head Random theme provides:

  • Blog Sidebar — Right sidebar on archive and single post pages.
  • Footer Widgets — Footer zone across all frontend pages.

Custom themes can register additional Widget Areas. See Building a Custom Theme for implementation details.

Shortcodes

Shortcodes provide an alternative way to embed dynamic content directly inside post or page content using simple bracket syntax.

Available Shortcodes

ShortcodeDescription
[recent_posts count="5"]Display latest posts inline
[post id="42"]Embed a specific post
[categories]Render a category list

Using Shortcodes

Insert shortcode syntax anywhere in the TinyMCE editor content area. PolyCMS parses and renders shortcodes when the page loads on the frontend.

For creating custom shortcodes, see the Shortcode Development Guide.

Related Documentation