Upsells Block in Optiontics: Product Page Add-Ons

Overview #

The Upsells block shows optional extras on the product page, so a customer can add them without leaving the page they are buying from. Each extra is one of your real products, with its own price and stock. It is part of Optiontics Pro and reads the linked products you have already set in WooCommerce.

WooCommerce puts related products at the very bottom of the page, below the description and the reviews. Clicking one takes the customer away from the thing they were about to buy. An extra that costs three pounds is not worth a second page load, so most of the time it never gets added at all. This block puts those extras next to the add-to-cart button instead, as a tick the customer can take or ignore.

Requirements #

• WooCommerce and the free Optiontics plugin, both active
• Optiontics Pro, where this block lives

Step 1: Set the extras up in WooCommerce first #

The block reads a list you keep on each product, so fill that in before you build anything.

1. Open a product and scroll to Product data.
2. Click the Linked Products tab.
3. In Cross-sells, search for and add the extras you want offered.
4. Update the product.

If you sell a burger, your fries, a drink and an extra sauce probably belong here already. Many shops have filled this in years ago and forgotten it.

Which field you use matters, and WooCommerce’s own wording is the guide:

• Cross-sells means “buy this as well”. Fries with the burger. This is almost always the one you want.
• Upsells means “buy this instead”. A bigger burger rather than this one.

Note: Point the block at Upsells and you will offer the customer a replacement for the product they are looking at, which is rarely what a shop intends.

Step 2: Add the Upsells block #

1. Go to Optiontics → Options and click Add New.
2. Click Add Elements.
3. Under Custom, click Upsells.
4. Set the Title to whatever you want above the extras, for example “Anything else?” or “Add to your order”.

The block arrives already pointing at Cross-sells, so a product with that field filled in works straight away with no further setup.

Step 3: Understand the defaults #

Under Upsell rules you will find three numbers already set.

Setting	Default	What it means for the customer
Min Qty	0	Nothing is required. They can buy with no extras at all
Max Qty	0	No ceiling. They can take everything on offer
Max Qty per Product	1	One of each

Because the per-product limit is 1, the extras appear as ticks rather than plus and minus buttons. A stepper that can only go from zero to one gives the customer two dead controls to look at. A tick is one click.

Raise Max Qty per Product to 3 and the ticks become steppers, which is what you want if somebody might reasonably order two sauces.

There is no counter above the extras and add to cart is never blocked, because nothing here is required.

Step 4: Style it and put it on your products #

1. Open the Appearance tab and set Layout, Columns, image size and colours to match your theme.
2. Click Publish.
3. In Product Selection, choose All Woo Products, Specific Woo Products, or Specific Woo Category, then click Create.

Because each product carries its own cross-sell list, one option set assigned to all products gives every product its own extras. You build this once.

Step 5: What your customer sees #

The extras appear on the product page as cards with a tick. The customer takes what they want and adds to cart, or takes nothing and adds to cart, and either works.

In the cart each extra is its own line, indented under the product it was added to, so the customer can see what they agreed to. Stock moves for each one, and your reports show which extras actually sell.

Frequently Asked Questions #

Q: What is the difference between Cross-sells and Upsells in the source setting? They are two separate lists WooCommerce keeps on every product. Cross-sells means “buy this as well”, such as fries with a burger. Upsells means “buy this instead”, such as a larger size. The block reads whichever list you point it at, so use Cross-sells for extras.

Q: Why does the block not appear on some products? Because that product’s linked list is empty. Rather than showing an empty grid with a heading and nothing under it, the block renders nothing at all, so the product page looks untouched. Add cross-sells to that product and it appears.

Q: Can a customer take two of the same extra? Not by default. Max Qty per Product is set to 1, which is what turns the cards into ticks. Change it to 2 or more and the ticks become plus and minus steppers, so a customer can order two sauces or three sets of candles.

Conclusion #

The Upsells block puts optional extras where the customer is already deciding, and keeps them as real products with real stock. Next, look at the Mix & Match Products block if you also want customers to build their own selection.