Troubleshoot Hit Highlighting Conflicts During Drupal Migration

Updated

If you see field '<field_name>' was indexed without offsets, cannot highlight during a Drupal migration, Drupal and SearchStax Site Search are both trying to handle highlighting for the same search results.

To fix the issue, use only one highlighting method. Either let SearchStax Site Search handle highlighting, or keep highlighting in Drupal and turn off highlighting in SearchStax.

Choose Where to Manage Highlighting

Manage Highlighting in SearchStax Site Search

Use these steps when you want SearchStax Site Search to highlight keyword matches in the fields displayed for search results.

Route Drupal highlighting settings to Site Search

  1. In Drupal admin, go to Configuration > Search and metadata > SearchStax settings.
  2. Make sure Re-route searches via Site Search configurations is checked.
  3. Check Highlighting settings.
  4. Save the Drupal configuration.

Enable hit highlighting in Site Search

  1. In Site Search, open your Search App.
  2. Go to Configurations > Basic Configurations > Results Fields.
  3. Check Hit Highlighting.
  4. Publish your changes.

Turn off Drupal excerpt highlighting if needed

If you don't need Drupal search excerpts, turn off Drupal-side excerpt highlighting before you configure the SearchStax server to retrieve highlighted snippets.

  1. In Drupal admin, go to Configuration > Search and metadata > Search API.
  2. Open the Search API configuration where you manage the Highlight processor or search excerpts highlighting.
  3. Uncheck the Highlight processor and search excerpts highlighting if either setting was checked previously.
  4. Save your changes.

Note: Search excerpts aren't available after you uncheck the Highlight processor. Leave the processor checked if you include excerpts in your search results.

Retrieve highlighted snippets from SearchStax

  1. In Drupal admin, go to Configuration > Search and metadata > Search API.
  2. Find your SearchStax server and edit it.
  3. Under Advanced, check Retrieve highlighted snippets.
  4. Save the server settings.

Use highlighted data in Drupal Views

If you're using Drupal Views, update each field that should display highlighting.

  1. Go to Structure > Views and edit your search view.
  2. In the Fields section, edit each field you want to highlight.
  3. Check Use highlighted field data for each field you want to highlight.
  4. Apply the field changes, and then save the view.

Manage Highlighting in Drupal

Use these steps when you want Drupal's highlighting configuration to stay in place.

Keep highlighting settings in Drupal

  1. In Drupal admin, go to Configuration > Search and metadata > SearchStax settings.
  2. Make sure Re-route searches via Site Search configurations is checked.
  3. Uncheck Highlighting settings.
  4. Save the Drupal configuration.

Turn off hit highlighting in Site Search

  1. In Site Search, open your Search App.
  2. Go to Configurations > Basic Configurations > Results Fields.
  3. Make sure Hit Highlighting is unchecked.
  4. Publish your changes.

Next Steps

Articles in this section