For the complete documentation index, see llms.txt. This page is also available as Markdown.

Product sorting

How the display order of products is decided in Content Egg blocks and shortcodes — drag-and-drop, chosen order, price templates, and sort options.

The order products appear in is set mainly by drag-and-drop, with a few rules that can take over (a price-sorting template, or an explicit sort).

Arrange products by hand

In the product manager, drag attached products into the order you want. This sets a position that's saved with the post and used across all your product blocks.

Dragging attached products to reorder them
Drag attached products to set their order

You can also set an exact position with the numeric Order field in a product's edit drawer, under More fields — handy for precise tweaks. Drag-and-drop is the usual way.

A product title that starts with a number in square brackets — [1] Osprey Talon 6 — counts as a manual position too. The brackets are stripped before the title is displayed, so a product can end up ordered by hand without any visible sign of it.

What decides the final order

For the CE Products block and [content-egg-block] shortcodes, the display order is decided in this priority:

  1. A sort parameter, if set — sorts by price, discount, reverse, or total_price (with order set to asc or desc). This overrides everything else, including your manual order. See Shortcode parameters.

  2. Price-focused templates — some templates sort by price (ascending) with no sort set: Price Comparison, Price Comparison Card, Offers Logo/Offers List variants, Price Alert, Price Statistics, Review Box, and similar. Other templates (Grid, List, Top Listing, Buttons Row, and custom templates) keep your chosen order.

  3. A specific list of products — when you use Choose products binding, or a manual products="…" filter, the block renders the products in the exact order you picked or listed them.

  4. Your manual order — otherwise (Filter mode by module, group, or all), products follow your drag-and-drop order. Products you haven't arranged yet fall back to badge-first, then each module's priority.

sort=reverse is the exception: it reverses the natural order rather than replacing it, so on hand-arranged products it gives you your own order backwards.

To force a strict price sort, add sort / order to a [content-egg-block] shortcode. A price-focused template does the same on its own, as long as the products have no manual order.

Egg Blocks

Egg Blocks that show products — Product Card, Quick Picks, Comparison Table — render products in the exact order you add them in the block. There's no drag-to-reorder and no automatic price sorting inside these blocks. To change the order, remove and re-add the products in the order you want.

Last updated