Why SearchStax Changes Aren't Affecting the Drupal View Search Experience

Updated

Changes you make in the Site Search dashboard may not appear in your Drupal View search experience. This happens because Drupal Views override Site Search settings for display and relevancy.

Understanding the Two Types of SearchStax Features

Site Search features fall into two distinct categories. Each has different requirements for working with Drupal Views.

Search Page UX features:

  • Results Fields Display
  • Faceting
  • Sorting
  • Spellcheck
  • Related Searches
  • Popular Searches

Search Results Relevancy features:

  • Search Fields
  • Ranking & Smart Ranking
  • Rules
  • Promotions
  • Auto-Suggest

Search Page UX Features Require UI Kits

When you use Drupal Views, the view controls the display of search results and the entire search user experience. Your Drupal View configuration overrides the Site Search settings for Results Fields, Faceting, Sorting, and other UX features.

To use Site Search UX features, implement a Search UI Kit instead of Drupal Views. This lets your team rapidly modify search page functionality.

Tip: UI Kits come with pre-built components for search functionality with full API integrations. They're available for JavaScript, Vue, React, and Angular frameworks. For detailed instructions on implementing UI Kits with Drupal, see Develop a search UI with UI Kits.

Search Results Relevancy Features Require Search API Changes

By default, Drupal Views control the relevancy of results returned from the search index when you use Search API. To override this behavior, update your Drupal Search API settings. This enables you to use Search Fields, Ranking, Rules, and Promotions configured in Site Search.

Enable SearchStax Relevancy in Drupal

  1. In your Drupal admin, go to Configuration > Search and metadata > SearchStax settings.
  2. Check the Re-route searches through Site Search option. This routes all search requests to the Site Search handler.
  3. Enable Configure searches via Site Search to ignore Drupal search settings (recommended).
  4. Check Parse mode and search fields to enable features like Rules and Promotions. This stops Drupal from rewriting the query or choosing which fields to search, so SearchStax Site Search can apply your relevance settings. If your Drupal Views rely on AND/OR keyword logic or you have multiple Views that share one index, leave Parse mode and searched fields cleared so Views can keep controlling that behavior.
  5. We also recommend enabling:
    • Highlight settings
    • Spellcheck settings
    • Sorts
  6. Click Save.

Clear your Drupal cache. Then confirm that searches now reflect the relevancy settings you configured in your Site Search App.

After enabling these settings, your Drupal search uses SearchStax relevancy instead of Drupal's default relevancy scoring.

What's Next

For more information about Drupal View limitations with SearchStax features, see Search experience development.

To implement UI Kits for enhanced search functionality, see Develop a search UI with UI Kits.

Articles in this section