1. Home
  2. Docs
  3. Divi Extended Loop
  4. Modules
  5. Extended Filter

Extended Filter

The Extended Filter module adds AJAX-driven filtering to any Divi 5 loop. It connects to a loop already on the page and lets visitors narrow the results — by search, taxonomy, author, sort order, custom field, or date — without a full page reload. Results update instantly (Auto mode) or when the visitor clicks submit (Submit mode), and the loop plus any connected Extended Pagination are swapped in place.

Getting Started

  1. Add the Extended Filter module.
  2. Set the Target Loop to the loop you want to filter.
  3. Choose an Apply Mode (Submit or Auto).
  4. Add one or more Filter items and configure each one's Field Type and options.

When a visitor changes a control (or submits the form), the filtered results are fetched in the background and swapped into the loop — the page itself never reloads.

Content Settings

Target

1. Target Loop

Choose which loop on the page this filter should control.

  • Main Query – No loop is selected. The module does not render until a loop is chosen.
  • Every active loop on the page is listed here automatically, named after the module it belongs to.

2. Apply Mode

Choose when the filtered results are fetched.

  • Submit – (default) Results update when the visitor clicks the Submit button.
  • Auto – Results update automatically as the visitor changes controls. Search inputs use a short debounce so the request is not fired on every keystroke.

Elements

Add one or more Filter child items here. Each item renders a single control — a search box, a dropdown, a checkbox list, a button, and so on. The order of the items determines the order of the controls in the form.

Filter Items

Each Filter item has a Field Type that determines the control it renders and the options it exposes.

3. Field Type

Choose the control this filter item renders.

  • Search – A search text input.
  • Taxonomy – A dropdown, radio group, or checkbox list of terms from a chosen taxonomy.
  • Author – A dropdown, radio group, or checkbox list of authors.
  • Sort – A dropdown for ordering the results.
  • Custom Field – A dropdown, radio group, or checkbox list that filters by a post meta key.
  • Date – One or two date inputs for filtering by date.
  • Submit – A submit button.
  • Reset – A reset button that clears all filter controls.

4. Label

The text shown above the control.

5. Show Label

Turn on to display the label above the control.

6. Placeholder

The placeholder text for the search input, and the empty ("any") option for the taxonomy, author, custom field, and sort dropdowns.

7. Description

Optional text shown below the control. If left empty, nothing is rendered.

8. Display As

(Taxonomy, Author, and Custom Field types only) Choose how the choices are shown.

  • Dropdown – (default) A single-select dropdown.
  • Radio Group – A single-select list of radio buttons, with an "any" option to clear the filter.
  • Checkbox List – A multi-select list of checkboxes, so visitors can pick more than one value.

Taxonomy Field

9. Taxonomy

The taxonomy to list terms from, for example category or post_tag.

Author Field

10. Exclude Authors

A comma-separated list of author IDs to exclude from the author control.

Sort Field

11. Sort Options

Add one or more sorting choices for the dropdown. Each option has:

  • Name – The label shown to visitors.
  • Order By – The field to sort by (date, title, and so on).
  • Order – Ascending or Descending.
  • Meta Key – Optional, used when ordering by a custom field value.

Custom Field Field

12. Custom Field Name

The custom field (post meta) key to filter by, for example city or an ACF field name.

13. Custom Field Mode

  • Manual – (default) Define the values yourself in Custom Field Values.
  • Auto – Automatically fetches the distinct values for the field from the loop's posts (cached for performance).

14. Custom Field Values

(Manual mode only) The possible values, as a comma-separated list formatted as value:label — for example red:Red, blue:Blue.

Date Field

15. Date Mode

  • Range – (default) Shows two date inputs ("after" and "before") to filter a date range.
  • Single – Shows one date input, compared against a chosen operator.

16. Compare Operator

(Single mode only) How the single date is compared: After, On or After, Before, On or Before, or On.

Submit / Reset Fields

17. Button Text

The text shown on the submit or reset button.

Design Settings

Input Field

Controls the appearance of the filter's search inputs and dropdowns. Available on the Filter module, and per-item on each Filter item.

  • Font – Typography for the input and select text.
  • Spacing – Padding and margin for the inputs and selects.
  • Sizing – Width and sizing.
  • Background – Background color of the inputs and selects.
  • Border – Border controls for the inputs and selects.
  • Box Shadow – Box shadow for the inputs and selects.

Loader

The loader appears inside the loop while filtered results are being fetched.

18. Loading Text

The text shown alongside the loader. Default: Loading.

19. Background Color

The background color of the loader wrapper.

20. Size

The size of the loader spinner (20–300 px). Default: 48px.

21. Border

The border styling of the loader spinner — width, color, and radius (used to create the spinning ring).

Module Design Settings

The module also includes the standard Divi 5 design options — layout, sizing, spacing, border, box shadow, filters, transform, and animation.

How can we help?