Theme Builder · Elementor
TB - Related Posts widget for Elementor
TB - Related Posts is a Theme Builder field. Add it on a King Addons Theme Builder template (single, archive, 404) so it can read the current query — not on a generic landing page.
Get King Addons
This page describes the PHP/JS for this widget — not a renamed stub. Install the free plugin from WordPress.org.
What it actually does
TB - Related Posts is a Theme Builder field. Add it on a King Addons Theme Builder template (single, archive, 404) so it can read the current query — not on a generic landing page.
Theme Builder Related Posts widget (Free).
Content is loaded with WP_Query in PHP (not a hardcoded list in the editor).
Some inspector controls are marked Pro in PHP (eicon-pro-icon / king-addons-pro-control). Those need King Addons Pro, not Elementor Pro.
How to add it in Elementor
- Install King Addons. Install Elementor and King Addons. Get King Addons from WordPress.org.
- Open a Theme Builder template. Place this widget on a King Addons Theme Builder template (single, archive, 404), not a random landing page.
- Insert the widget. Search the panel for “TB - Related Posts”. Typing “king” lists every King Addons widget.
- Set inspector controls from this widget’s PHP. Configure “Source (Pro)”, “Taxonomy Slug (Pro)”, “Posts Per Page”, “Order (Pro)”. Style and Content tabs are listed on this page.
When to use it
- A single-post template that needs TB - Related Posts.
- An archive or 404 template in Theme Builder.
- A dynamic layout where the content comes from the current query.
Inspector controls from this widget’s PHP
| Control | What the code does |
|---|---|
| Query — Source (Pro) | The chosen value is read in render() and applied on the front end. Options: Same Categories; Same Tags; Same Tags %s; Same Taxonomy; Same Taxonomy %s. |
| Query — Taxonomy Slug (Pro) | Saved on the widget and consumed in render(). |
| Query — Posts Per Page | WP_Query `posts_per_page` — how many posts are fetched (default 3, min 1, max 12). |
| Query — Order (Pro) | The chosen value is read in render() and applied on the front end. Options: Date; Random; Comment Count; Comment Count %s. |
| Query — Exclude Current Post | Switcher inspector control (`kng_exclude_current`). |
| Query — Kng Fallback (Pro) | Selects the value used for WP_Query posts_per_page. Options: Hide Widget; Show Latest Posts. |
| Layout — Columns | Spacing/size control (min 1, max 4). |
| Layout — Show Featured Image | Passed through to the featured image. |
| Layout — Show Title | Passed through to the post title. |
| Layout — Show Meta | Switcher inspector control (`kng_show_meta`). |
| Layout — Show Excerpt | Passed through to the excerpt produced by wp_trim_words(). |
| Layout — Show Read More | Passed through to the post permalink. |
| Style — Title Typography | Elementor typography group: family, size, weight, transform, style, decoration, line-height, letter-spacing. Selector: `{{WRAPPER}} .king-addons-tb-related-posts__title`. |
| Style — Meta Typography | Elementor typography group: family, size, weight, transform, style, decoration, line-height, letter-spacing. Selector: `{{WRAPPER}} .king-addons-tb-related-posts__meta`. |
| Style — Title Color | Writes CSS `color` onto the widget’s front-end markup. |
| Style — Meta Color | Writes CSS `color` onto the widget’s front-end markup. |
| Style — Grid Gap | Writes CSS `gap` onto the widget’s front-end markup. (min 0, max 60). |
Content and Style tabs from this widget’s PHP, including repeater fields and group controls (typography, background, border, shadow). Elementor’s Advanced tab is core Elementor and is not listed here.
FAQ
Which TB - Related Posts options need King Addons Pro?
Controls marked with the Pro icon in this widget’s PHP. King Addons Pro is a separate license from Elementor Pro.
Why is TB - Related Posts empty on a normal page?
Theme Builder widgets read the current query. Edit a Theme Builder template (single/archive/404) and preview a real post or archive.
Do I need Elementor Pro?
No. King Addons runs on free Elementor. Some King Addons options (for example template-in-accordion, extra popup conditions, parts of the template catalog) need King Addons Pro — not Elementor Pro.
Related theme builder widgets
TB - Archive Posts
TB - Archive Posts is a Theme Builder field. Add it on a King Addons Theme Builder template (single, archive, 404) so it can read the current query — not on a generic landing page.
TB - Author Box
TB - Author Box is a Theme Builder field. Add it on a King Addons Theme Builder template (single, archive, 404) so it can read the current query — not on a generic landing page.
TB - Featured Image
TB - Featured Image is a Theme Builder field. Add it on a King Addons Theme Builder template (single, archive, 404) so it can read the current query — not on a generic landing page.
TB - Post Comments
TB - Post Comments is a Theme Builder field. Add it on a King Addons Theme Builder template (single, archive, 404) so it can read the current query — not on a generic landing page.
TB - Post Content
TB - Post Content is a Theme Builder field. Add it on a King Addons Theme Builder template (single, archive, 404) so it can read the current query — not on a generic landing page.
TB - Post Excerpt
TB - Post Excerpt is a Theme Builder field. Add it on a King Addons Theme Builder template (single, archive, 404) so it can read the current query — not on a generic landing page.
Get King Addons
One free plugin. 80+ Elementor widgets, 650+ templates, and 4,000+ sections. Search for TB - Related Posts after you activate it.