Widgets

Add and arrange content blocks — called widgets — in your theme's designated areas.

TL;DR

Go to Admin → Widgets. Select a widget type from the dropdown, choose a target area (sidebar, footer, etc.), and click Add. Configure each widget instance independently. Drag to reorder. Click X to remove a widget.

Details

What Are Widgets?

Widgets are self-contained content blocks that are placed into widget areas defined by the active theme. Each theme specifies which areas it supports. The standard set of areas is:

• sidebar — the primary sidebar column (usually on blog/post pages)
• footer-1, footer-2, footer-3 — three footer columns
• before-content — a full-width area above the main content area

Adding a Widget

1. On the Widgets page, locate the Add Widget form.
2. Select a widget type from the dropdown (e.g., "Recent Posts", "Text Block").
3. Choose the target area where the widget should appear.
4. Click Add.

The widget instance appears at the bottom of the chosen area. It is immediately live on the site.

Configuring a Widget Instance

Each widget instance has its own settings, independent of other instances of the same widget type. Click the widget card to expand its options form. For example:

• A Recent Posts widget lets you set a title, the number of posts to show, and whether to display dates and excerpts.
• A Text Block widget has a title and a full HTML/text content textarea.

Click Save after editing options.

Reordering Widgets

Within each area, drag widget cards up or down to change their display order. The new order is saved automatically when you drop the card.

Removing a Widget

Click the X button on any widget card to remove that instance. This does not affect other instances of the same widget type elsewhere.

Widget Areas and Theme Switching

Widget instances are associated with named areas, not with a specific theme. If you switch to a theme that does not define a particular area, any widget instances assigned to that area will be collected into an "Orphaned" section on the Widgets page. They are not deleted — if you switch back to a theme that defines that area, they reappear.

Getting More Widgets

Additional widget types are available from Admin → Marketplace. See the Available Widgets article for a complete list of built-in widget types.

Widget Licensing

Free widgets activate without a license key. Paid third-party widgets require a license key entered on the admin Widgets page. The key is validated against the widget author's licensing server.

Disabled Widgets

Widgets with missing or invalid widget_info.json files are registered but disabled. A disabled badge and reason are shown on the admin Widgets page. Disabled widgets cannot be activated or rendered. Widgets flagged as malicious by the safety vetting system are also blocked from activation.