Skip to main content

Search Form

Purpose​

Use the Search Posts module to let visitors search a custom post type (and optional filters), then land on a Theme Builder search results layout with Archive Loop.

For instant suggestions while typing, see Live search and Auto suggest.

Set up the search form​

  1. Open the page, post, or Theme Builder layout where the form should appear.
  2. Add the Search Posts module and set Search Post Type under Main Options. See the Search Posts module reference for every setting.
  3. Add a Search Item for the keyword field (and any other filters you need).
  4. Style the module under the Design tab (text, icon, alignment, sizing).
  5. Go to Divi Engine → Machine Settings → Search settings and enable Use Divi Machine Search, then choose common fields and ACF groups to include.
  6. Create a Search Results Theme Builder template with Archive Loop and your custom loop layout.
  7. Optional: assign a No Results layout on the Archive Loop.

Live search and Auto suggest​

FeatureWhat visitors seeSetup
Live searchRich post/product dropdown (title, image, price, pagination, layouts)On the Text Search Filter Posts Item (or Search Posts child), turn on Live search (post results). Machine-only.
Auto suggestFast category/tag/phrase suggestionsEnable and rebuild the phrase index under Divi Ajax Filter → Auto suggest, then turn on Auto suggest on the Text Search item.
Site search formsLive search on Divi/theme search formsMachine Settings → Search settings → Enhance site search forms with live search
Search Posts dropdown only

Search Posts live search shows results in a dropdown only. To refresh a grid below the field while typing, use Filter Posts + Archive Loop (and optionally Update archive while typing).

  • Allow live search for Search Posts modules — Site-wide kill switch in Machine Search settings.
  • Opt out of a single enhanced form with data-dmach-live-search="off" on the form or field.

What's next​