Skip to main content

Category Loop Module

Divi 4 module

Outputs terms (core categories/tags or a custom taxonomy) instead of posts. Choose between the built-in card layout or a saved Loop Layout for full design control.

Overview

Category loop module overview

Typical placements:

  • Directory pages that need a visual grid of service areas.
  • Mega menus or landing pages that deep-link to each term archive.
  • Filter sidebars that list child terms under the current parent.

Module Options (loop source)

Category loop source settings

Return Type

Current Post reads terms attached to the post in view. Current Taxonomy adapts when you are already on a taxonomy archive. Custom Post (you define) and Custom Taxonomy (you define) let you point at another object entirely—pair them with Post Type or Taxonomy Slug as they appear.

Taxonomy Slug

Required when Return Type is Custom Taxonomy (you define). Enter the registered taxonomy slug exactly as WordPress stores it.

Post Type

Shown when you need a specific post type context while resolving terms (hidden for the default and pure taxonomy return paths per the builder logic).


Loop Options

Category loop layout mode

Layout Style

Default prints title, description, and optional image with minimal markup. Loop Layout defers rendering to a Divi Library layout saved for each term.

Loop Layout

Select the library layout when Layout Style is Loop Layout. Each term renders through that template once.

Link to Category Items?

Wraps the entire card in a link to the term archive. Disable extra <a> tags inside your custom layout to avoid nested anchors.

Filter By ACF Field

Limit which terms appear based on an ACF value stored on the term (for example a “featured” toggle).

ACF Value

The value that must match the selected ACF field for a term to remain in the list.


Layout and grid options

Category loop grid settings

Grid Layout Style

Switch between Grid cards and a List hierarchy with independent padding controls.

Parent List Padding

Padding wrapper for top-level list rows when using list mode.

Child List Padding

Padding for nested child rows in list mode.

Image Name

Select the ACF image field attached to each term record when grid mode should show photography.

Title HTML Tag

Choose the heading level (or p) for the term title in default mode.

Image Return Format

Match how the ACF image field is configured—Array vs URL—so the module can decode attachments correctly.

Column Style

Controls image/title stacking: Title On Top Image, Title Below Image, or Image on left of Title when grid mode is active.

Grid Columns

Desktop column count for the grid.

Tablet Grid Columns

Breakpoint-specific column count.

Mobile Grid Columns

Narrow-screen column count (one or two columns).

Text Orientation

Aligns text blocks within each card.

Hide Descriptions

Strips description copy so only imagery/titles remain.

Hide Titles

Opposite of the above—image-only cards.

Orderby

Sort terms by name, count, ID, or other supported orderings exposed in the select list.

Design exposes Title, Active Title, Description, card shadows, borders, and overlay controls for hover states.


What is next