Skip to main content

Orderby Module

Divi 4 module

Use Orderby next to Archive Loop (or any Machine loop that reads the same query parameters) so visitors can change how results are sorted.

Overview

Orderby module overview

The module is a parent + children pattern:

  • Orderby — container; sets where the <select> is injected.
  • Orderby Item — one child per option (date, title, ACF meta, etc.).

Add the parent, set Orderby Location, then add one Orderby Item per sort choice.


Parent: Orderby

Orderby parent settings

Orderby Location

Controls where the generated sort control appears relative to your loop markup (for example before or after the archive). Pair this with the same page structure you use for Archive Loop so the control and results stay in sync.

Background Color

Optional background styling for the orderby wrapper. Use Design for full spacing and typography if you need more than a flat color.


Child: Orderby Item

Orderby item settings

Each child row becomes one <option> in the shared dropdown.

Orderby Name

Internal label so you can tell rows apart in the builder. It is not the text visitors see in the dropdown; that text comes from the sort type you pick next.

What do you want to add to the orderby select option?

Pick the kind of sort this row represents (core sorts such as date or title, relevance, or acf when the sort should use a custom field). Choosing acf reveals ACF Name.

ACF Name

Shown when the row is an ACF-based sort. Select the field whose value should drive ordering. Enable Is Numeric? when the stored values should compare as numbers rather than strings.

Ascending or Descending?

Sets ASC vs DESC for this row’s query argument.

Is Numeric?

Turn on when the ACF values are numeric so WordPress orders them numerically. Leave off for normal text/date fields.


What is next