Skip to main content
Documentation/Elements & Controls Reference/Elements/WooCommerce/Upsell Products

Upsell Products

Upsell Products displays products assigned as upsells for the current or selected WooCommerce product. WooCommerce must be installed and active.

Add and configure Upsell Products

  1. Click Add, choose Upsell Products, and place it in the container.
  2. Configure Content > Content > Product where a fixed selection is intended.
  3. Set Product Count, Order By, and Order.
  4. Style Container, Elements, Layout, Product Wrapper, Title, and Spacing.
  5. Save your changes.
Upsell Products controls in the Breakdance editor
Upsell Products controls in the Breakdance editor

This element has no children; use its own controls.

Controls

Responsive varies by breakpoint; Hover has a hover value; Shared applies across both. Linked controls have their own reference. In conditions, = means “is” and ≠ means “is not.”

Content > Content

Setting Purpose and options Behavior
Product Set product. Shared
Product Count Set the numeric product count value. Shared
Order By Date, Price, Random. Shared
Order Descending, Ascending. Shared

Design > Container

Setting Purpose and options Behavior
Size Size and unit. Responsive
Background Color or supported fill. Shared
Borders borders controls. See linked controls
Padding spacing controls. See linked controls

Design > Elements

Setting Purpose and options Behavior
Image > Include Enable, Disable. Shared
Image > Space Before Space before and unit. Responsive
Image > Space After Space after and unit. Responsive
Image > Order Numeric order. Responsive
Image > Borders borders controls. See linked controls
Image > Show Second Image On Hover On/off. Shared
Image > Transition Duration Transition duration. When: Show Second Image On Hover is set. Shared
Title > Include Enable, Disable. Shared
Title > Space After Space after and unit. Responsive
Title > Order Numeric order. Responsive
Title > Typography typography controls. See linked controls
Price > Include Enable, Disable. Shared
Price > Space After Space after and unit. Responsive
Price > Order Numeric order. Responsive
Price > Old Price Typography typography controls. See linked controls
Price > Current Price Typography typography controls. See linked controls
Rating > Include Enable, Disable. Shared
Rating > Space After Space after and unit. Responsive
Rating > Order Numeric order. Responsive
Rating > Review Count On/off. Shared
Rating > Count Typography typography controls. See linked controls
Sale Badge > Include Enable, Disable. Shared
Sale Badge > Position Top Left, Top Right. Responsive
Sale Badge > Background Color or supported fill. Shared
Sale Badge > Typography typography controls. See linked controls
Sale Badge > Borders borders controls. See linked controls
Sale Badge > Padding spacing controls. See linked controls
Sale Badge > Nudge > X X and unit. Responsive
Sale Badge > Nudge > Y Y and unit. Responsive
Excerpt > Include Enable, Disable. Shared
Excerpt > Space After Space after and unit. Responsive
Excerpt > Order Numeric order. Responsive
Excerpt > Typography typography controls. See linked controls
Categories > Include Enable, Disable. Shared
Categories > Space After Space after and unit. Responsive
Categories > Order Numeric order. Responsive
Categories > Typography typography controls. See linked controls
Quantity Input > Include Enable, Disable. Shared
Quantity Input > Space After Space after and unit. Responsive
Button > Include Enable, Disable. Shared
Button > Space After Space after and unit. When: Include = Enable. Responsive
Button > Styles > Size > Size Custom, Small, Default, Large. Responsive
Button > Styles > Size > Padding Padding. When: Size = Custom. Responsive
Button > Styles > Size > Override Width Override width and unit. Shared
Button > Styles > Size > Full Width At Breakpoint. Shared
Button > Styles > Background Color or supported fill. Hover
Button > Styles > Outline On/off. Shared

Shown when Outline is set.

Setting Purpose and options Behavior
Button > Styles > Color Color or supported fill. Hover
Button > Styles > Width Width. Shared
Button > Styles > No Fill On Hover On/off. Shared
Setting Purpose and options Behavior
Button > Styles > Typography typography controls. See linked controls
Button > Styles > Corners Square, Round, Custom. Shared
Button > Styles > Corner Radius Corner radius and unit. When: Corners = Custom. Responsive
Button > Styles > Effects > Transition Duration Transition duration. Responsive
Button > Styles > Effects > Scale On Hover Set scale on hover. Range: 0–3. Responsive
Button > Styles > Effects > Shadow Shadow offset, blur, spread, color. Responsive, Hover
Button > Styles > Icon > Icon Icon. Shared
Button > Styles > Icon > Position Before, After. Shared
Button > Styles > Icon > Size Size and unit. Responsive
Button > Styles > Icon > Color Color or supported fill. Hover
Button > Styles > Icon > Space Before Space before and unit. Responsive
Button > Styles > Icon > Space After Space after and unit. Responsive
Button > Styles > Icon > Hover Transform Hover transform and unit. Shared
Custom Areas > Areas Add, edit, remove, and reorder areas. Shared
Custom Areas > Areas > Global Block Existing Global Block. Shared
Custom Areas > Areas > Position Inside Link, Outside Link. Shared
Custom Areas > Areas > Space Before Space before and unit. Responsive
Custom Areas > Areas > Space After Space after and unit. Responsive
Custom Areas > Areas > Order Numeric order. Shared

Design > Layout

Setting Purpose and options Behavior
Layout Grid, Slider, Masonry. Shared
Slider slider controls. When: Layout = Slider. See linked controls
Products Per Row Set the numeric products per row value. When: Layout ≠ Slider. Responsive
Between Products Between products and unit. When: Layout ≠ Slider. Responsive

Design > Product Wrapper

Setting Purpose and options Behavior
Align Content Left, Center, Right. Shared
Background Color or supported fill. Shared
Borders borders controls. See linked controls
Padding spacing controls. See linked controls

Design > Title

Setting Purpose and options Behavior
Disable On/off. Shared
Typography typography controls. See linked controls

Design > Spacing

Setting Purpose and options Behavior
Below Title Below title and unit. Responsive
Container spacing controls. See linked controls

Design > Advanced

Setting Purpose and options Behavior
Override Global Styles woocommerce global styles. See linked controls

Troubleshooting

No upsells appear

Assign upsell products in the product's WooCommerce linked-product settings.

The wrong product's upsells appear

Check the element's Product selection and the current template context.