WooCommerce · Elementor
Quick Product Grid widget for Elementor
A compact product grid with simple columns and spacing.
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
A compact product grid with simple columns and spacing.
Quick Product Grid Widget (Free).
render() writes HTML data attributes: data-product_id, data-product_sku, data-quantity.
Content is loaded with WP_Query in PHP (not a hardcoded list in the editor).
Output depends on WooCommerce objects (products, cart, or account). Empty without WooCommerce data.
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.
- Edit with Elementor. Open a page and click Edit with Elementor.
- Insert the widget. Search the panel for “Quick Product Grid”. Typing “king” lists every King Addons widget.
- Set inspector controls from this widget’s PHP. Configure “Products Number”, “Order By”, “Order”, “Categories (Pro)”. Style and Content tabs are listed on this page.
When to use it
- A landing-page product set.
- A brand collection.
- A small shop homepage.
Tip: After King Addons is active, type king in the Elementor search box to list every widget, including Quick Product Grid.
Inspector controls from this widget’s PHP
| Control | What the code does |
|---|---|
| Query — Products Number | Free version limited to 12 products. |
| Query — Order By | The chosen value is read in render() and applied on the front end. Options: Date; Title; Price; Popularity; Rating; Random. |
| Query — Order | The chosen value is read in render() and applied on the front end. Options: DESC; ASC. |
| Query — Categories (Pro) | Comma-separated slugs. |
| Query — Include Products | Comma-separated product IDs. |
| Query — Exclude Products | Comma-separated product IDs. |
| Query — Show Only On Sale | Switcher inspector control (`kng_on_sale`). |
| Query — Show Only Featured | Switcher inspector control (`kng_featured_only`). |
| Query — Only In Stock | Switcher inspector control (`kng_in_stock`). |
| Layout — Columns | Writes CSS `grid-template-columns` onto the widget’s front-end markup. (default 3, min 1, max 6). |
| Layout — Gap | Writes CSS `gap` onto the widget’s front-end markup. (min 0, max 80). |
| Display — Show Rating | Switcher inspector control (`kng_show_rating`). |
| Display — Show Price | Switcher inspector control (`kng_show_price`). |
| Display — Show Short Description | Switcher inspector control (`kng_show_excerpt`). |
| Display — Show Add to Cart | Switcher inspector control (`kng_show_add_to_cart`). |
| Display — Show Sale Badge | Switcher inspector control (`kng_show_badge`). |
| Display — Sale Badge Text | Printed in the widget HTML from render(). |
| Display — Excerpt Length (words) | Numeric value used in this widget’s render/JS (default 16, min 5, max 60). |
| Display — Image Size | Elementor image-size group (thumbnail, medium, large, full, custom). |
| Animations — Hover Animation | The chosen value is read in render() and applied on the front end. Options: None; Small Lift; Lift; Image Zoom; Tilt; Float; Scale & Fade. |
| Card — Background | Writes CSS `background-color` onto the widget’s front-end markup. |
| Card — Border | Elementor border group: type, width, color, and radius when the group includes it. Selector: `{{WRAPPER}} .king-addons-quick-product-grid__card`. |
| Card — Border Radius | Writes CSS `border-radius` onto the widget’s front-end markup. (min 0, max 50). |
| Card — Box Shadow | Elementor box-shadow group for the selector. Selector: `{{WRAPPER}} .king-addons-quick-product-grid__card`. |
| Card — Disable Box Shadow | Switcher inspector control (`kng_card_shadow_disable`). |
| Card — Disable Box Shadow on Hover | Switcher inspector control (`kng_card_shadow_hover_disable`). |
| Card — Padding | Writes CSS `padding` onto the widget’s front-end markup. |
| Text — Typography | Elementor typography group: family, size, weight, transform, style, decoration, line-height, letter-spacing. Selector: `{{WRAPPER}} .king-addons-quick-product-grid__title`. |
| Text — Title Color | Writes CSS `color` onto the widget’s front-end markup. |
| Text — Typography (Kng Price Typography) | Elementor typography group: family, size, weight, transform, style, decoration, line-height, letter-spacing. Selector: `{{WRAPPER}} .king-addons-quick-product-grid__price`. |
| Text — Price Color | Writes CSS `color` onto the widget’s front-end markup. |
| Text — Typography (Kng Excerpt Typography) | Elementor typography group: family, size, weight, transform, style, decoration, line-height, letter-spacing. Selector: `{{WRAPPER}} .king-addons-quick-product-grid__excerpt`. |
| Text — Excerpt Color | Writes CSS `color` onto the widget’s front-end markup. |
| Rating — Empty Color | Writes CSS `color` onto the widget’s front-end markup. |
| Rating — Filled Color | Writes CSS `color` onto the widget’s front-end markup. |
| Rating — Size | Writes CSS `font-size` onto the widget’s front-end markup. (min 10, max 32). |
| Sale Badge — Typography | Elementor typography group: family, size, weight, transform, style, decoration, line-height, letter-spacing. Selector: `{{WRAPPER}} .king-addons-quick-product-grid__badge`. |
| Sale Badge — Text Color | Writes CSS `color` onto the widget’s front-end markup. |
| Sale Badge — Background | Writes CSS `background-color` onto the widget’s front-end markup. |
| Sale Badge — Border | Elementor border group: type, width, color, and radius when the group includes it. Selector: `{{WRAPPER}} .king-addons-quick-product-grid__badge`. |
| Sale Badge — Box Shadow | Elementor box-shadow group for the selector. Selector: `{{WRAPPER}} .king-addons-quick-product-grid__badge`. |
| Sale Badge — Border Radius | Writes CSS `border-radius` onto the widget’s front-end markup. (min 0, max 50). |
| Sale Badge — Padding | Writes CSS `padding` onto the widget’s front-end markup. |
| Sale Badge — Offset Top | Writes CSS `top` onto the widget’s front-end markup. (min 0, max 80). |
| Sale Badge — Offset Left | Writes CSS `left` onto the widget’s front-end markup. (min 0, max 80). |
| Add to Cart — Alignment | Writes CSS `justify-content` onto the widget’s front-end markup. Options: Start; Center; End. |
| Add to Cart — Full Width Button | Switcher inspector control (`kng_button_full_width`). |
| Add to Cart — Typography | Elementor typography group: family, size, weight, transform, style, decoration, line-height, letter-spacing. Selector: `{{WRAPPER}} .king-addons-quick-product-grid__cta .button`. |
| Add to Cart — Padding | Writes CSS `padding` onto the widget’s front-end markup. |
| Add to Cart — Indicator Size | Spacing/size control (min 8, max 40). |
| Add to Cart (Normal) — Text Color | Writes CSS `color` onto the widget’s front-end markup. |
| Add to Cart (Normal) — Background | Writes CSS `background-color` onto the widget’s front-end markup. |
| Add to Cart (Normal) — Border | Elementor border group: type, width, color, and radius when the group includes it. Selector: `{{WRAPPER}} .king-addons-quick-product-grid__cta .button`. |
| Add to Cart (Normal) — Box Shadow | Elementor box-shadow group for the selector. Selector: `{{WRAPPER}} .king-addons-quick-product-grid__cta .button`. |
| Add to Cart (Hover) — Hover Text Color | Writes CSS (button, color) onto the widget’s front-end markup. |
| Add to Cart (Hover) — Hover Background | Writes CSS (button, background-color) onto the widget’s front-end markup. |
| Add to Cart (Hover) — Border | Elementor border group: type, width, color, and radius when the group includes it. Selector: `{{WRAPPER}} .king-addons-quick-product-grid__cta .button:hover`. |
| Add to Cart (Hover) — Box Shadow | Elementor box-shadow group for the selector. Selector: `{{WRAPPER}} .king-addons-quick-product-grid__cta .button:hover`. |
| Add to Cart — Border Radius | Writes CSS `border-radius` onto the widget’s front-end markup. (min 0, max 40). |
| View Cart Link — Spacing From Button | Writes CSS `margin-left` onto the widget’s front-end markup. (min 0, max 60). |
| View Cart Link — Typography | Elementor typography group: family, size, weight, transform, style, decoration, line-height, letter-spacing. Selector: `{{WRAPPER}} .king-addons-quick-product-grid__cta .added_to_cart`. |
| View Cart Link — Padding | Writes CSS `padding` onto the widget’s front-end markup. |
| View Cart Link (Normal) — Text Color | Writes CSS `color` onto the widget’s front-end markup. |
| View Cart Link (Normal) — Background | Writes CSS `background-color` onto the widget’s front-end markup. |
| View Cart Link (Normal) — Border | Elementor border group: type, width, color, and radius when the group includes it. Selector: `{{WRAPPER}} .king-addons-quick-product-grid__cta .added_to_cart`. |
| View Cart Link (Normal) — Box Shadow | Elementor box-shadow group for the selector. Selector: `{{WRAPPER}} .king-addons-quick-product-grid__cta .added_to_cart`. |
| View Cart Link (Hover) — Hover Text Color | Writes CSS (cart, color) onto the widget’s front-end markup. |
| View Cart Link (Hover) — Hover Background | Writes CSS (cart, background-color) onto the widget’s front-end markup. |
| View Cart Link (Hover) — Border | Elementor border group: type, width, color, and radius when the group includes it. Selector: `{{WRAPPER}} .king-addons-quick-product-grid__cta .added_to_cart:hover`. |
| View Cart Link (Hover) — Box Shadow | Elementor box-shadow group for the selector. Selector: `{{WRAPPER}} .king-addons-quick-product-grid__cta .added_to_cart:hover`. |
| View Cart Link — Border Radius | Writes CSS `border-radius` onto the widget’s front-end markup. (min 0, max 40). |
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 Quick Product Grid 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.
Does Quick Product Grid require WooCommerce?
Yes. Install WooCommerce and add products (or complete a cart) before this widget has anything to show.
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 woocommerce widgets
Quick Product Slider
A compact product slider with fewer controls than WooCommerce Grid — for a simple featured row.
WooCommerce Grid & Slider
WooCommerce products in a grid, slider, or carousel with query and style controls. This is the main shop loop widget.
WC Product Category
Products from one WooCommerce category, with style controls.
WC Products
The WooCommerce products shortcode, with King Addons style controls around it.
Compare Products Table
A side-by-side comparison table of WooCommerce products the shopper selected.
WC Cart
The WooCommerce cart shortcode, styled in Elementor. Use on a cart template, not on a random marketing page.
Get King Addons
One free plugin. 80+ Elementor widgets, 650+ templates, and 4,000+ sections. Search for Quick Product Grid after you activate it.