Jump to main content Jump to doc navigation

SimpleSearchForm Snippet

This snippet displays a search form for SimpleSearch.


Simply place wherever you want a SearchForm to render, and add the 'landing' property to the call to specify the Resource where the SimpleSearch snippet call is located (which is where the results will display).

[[!SimpleSearchForm? &landing=`123`]]

If you'd like the results to show on the same page, simply place the SimpleSearch snippet call below the SimpleSearchForm call, and don't specify a 'landing' parameter.

Available Properties

Name Description Default
tpl The chunk that will be used to display the search form. SearchForm
landing The Resource that the SimpleSearch snippet is called on, that will display the results of the search.
searchIndex The name of the REQUEST parameter that the search will use. search
method Whether to send the search over POST or GET. GET
toPlaceholder Whether to set the output to directly return, or set to a placeholder with this propertys name.

SimpleSearchForm Chunks

There is 1 chunk that is processed in SimpleSearchForm. Its corresponding SimpleSearchForm parameter is:

  • tpl - The Chunk to use for the search form.


Display the search form, but search with POST instead of GET:

[[SimpleSearchForm? &method=`POST`]]

Set the search form to a 'search.form' placeholder, specify a landing page on Resource 123, and use a custom Chunk called 'MySearchForm' for the form template:

[[SimpleSearchForm? &tpl=`MySearchForm` &landing=`123` &toPlaceholder=`search.form`]]


Note that with current version (1.0.0) there seems to be a bug where if you ACTUALLY have a Chunk named "seachForm", its contents will be ignored in favor of the default search form.


If you get an error like the following after submitting a search:

There were no search results for the search "". Please try using more general terms to get more results.

Then that probably means that the SimpleSearch isn't looking in the right place in the $POST or $_GET array for your search term. If you created a custom &tpl for your SimpleSearchForm tpl, make sure that the name used for your search term variable is properly identified in your corresponding SimpleSearch Snippet call, e.g. note here how my_custom_search_field is used in the SimpleSearchForm tpl _and it's specified in the &searchIndex parameter of the SimpleSearch call:

SimpleSearchForm tpl

<form id="my_id" action="[[~[[+landing:default=`[[*id]]`]]]]" method="[[+method:default=`get`]]">
    <input id="searchField" class="my_class" type="text" name="my_custom_search_field" value="[[+searchValue:default=`Search the site`]]"/>
    <input id="searchIcon" class="utilityButton" type="image" alt="Search" src="/assets/templates/my/images/searchButton.png">
    <input type="hidden" name="id" value="[[+landing:default=[[*id]]]]" />

SimpleSearch Snippet call

[[!SimpleSearch? &searchIndex=`my_custom_search_field`]]

See Also

  1. SimpleSearch.SimpleSearch
    1. SimpleSearch.SimpleSearch.containerTpl
    2. SimpleSearch.SimpleSearch.currentPageTpl
    3. SimpleSearch.SimpleSearch.pageTpl
    4. SimpleSearch.SimpleSearch.tpl
    5. SimpleSearch.Faceted Search Through PostHooks
  2. SimpleSearch.SimpleSearchForm
    1. SimpleSearch.SimpleSearchForm.tpl
  3. SimpleSearch.Solr

Support the team building MODX with a monthly donation.

The budget raised through OpenCollective is transparent, including payouts, and any contributor can apply to be paid for their work on MODX.



$0 per month—let's make that $500!

Learn more