Skip to main content

Ajax filter module behavior

Divi 5 only

Module-level options are documented in Filter Posts. This guide groups the behaviors most teams configure first.

Connect filters to results

  • Post type — Must match the Archive Loop (and any nested query) so Ajax requests return the same content type.
  • Target loop — Select the Archive Loop module that should refresh when filters change. Multiple loops on one page each need a clear target.
  • Update methodOn change updates as visitors pick options; Button waits for an explicit apply action. Use a button when filters are expensive or numerous.

Layout and presentation

Filter Posts supports stacked, inline, and toggle-style layouts (including mobile-specific layouts). Use Filter layout and related design groups to match your header or sidebar pattern.

Selected filters and Reset help visitors see active criteria and start over without reloading the page. Style chips and reset in the Design tab when they are enabled on the Content tab.

Empty and contextual filters

Performance and UX notes

  • Prefer On change for small filter sets; use Button for many simultaneous fields.
  • Keep Target loop unique per filter bar when multiple loops share a page.
  • Test mobile layout separately—narrow breakpoints often need a toggle or off-canvas filter panel.

What's next