Result Settings Guide

Result Settings will test your queries and provide one of four performance labels:

The label you receive depends on which fields you have enabled and how heavy the fields are to compute.

Each field, whether raw or snippet, has a default size and then a configurable range.

But what are raw and snippet fields?

A raw field defaults to the full field with no character limit outside of max document size. The custom range is between 20-1000 characters.

A snippet field defaults to 100 characters. The custom range is 20-1000 characters.

Only text fields provide these two options, as they are functions of the deep full-text search capabilities of App Search.

You can imagine - given their functions - that one might be more robust to compute than the other.

A default query with many large 250+ character snippet fields will be heavier than the same number of large raw fields.

It’s worth it, though, for the richness that highlighting can provide.

And it opens the ability to find your application’s "sweet spot" for robustness of results and query performance.

Let’s look at an example Optimal search query:

Result Settings - Customizing your results.

Consider the default object that represents a park in the National Park example Engine:

{
  "nps_link": {
    "raw": "https://www.nps.gov/grsm/index.htm"
  },
  "title": {
    "raw": "Great Smoky Mountains"
  },
  "date_established": {
    "raw": "1934-06-15T05:00:00+00:00"
  },
  "world_heritage_site": {
    "raw": "true"
  },
  "states": {
    "raw": [
      "Tennessee",
      "North Carolina"
    ]
  },
  "description": {
    "raw": "The Great Smoky Mountains, part of the Appalachian Mountains, span a wide range of elevations, making them home to over 400 vertebrate species, 100 tree species, and 5000 plant species. Hiking is the park's main attraction, with over 800 miles (1,300 km) of trails, including 70 miles (110 km) of the Appalachian Trail. Other activities include fishing, horseback riding, and touring nearly 80 historic structures."
  },
  "visitors": {
    "raw": 11312786
  },
  "id": {
    "raw": "park_great-smoky-mountains"
  },
  "location": {
    "raw": "35.68,-83.53"
  },
  "square_km": {
    "raw": 2114.2
  },
  "acres": {
    "raw": 522426.88
  }
}

All of that information will be returned - per result - when you perform a basic query.

All the information might not be needed depending on how you’ve designed the user experience.

That is neither performant, nor tidy to manage with your front-end components.

As pictured above, you can disable some fields and enrich some others.

We want an object as concise as this:

{
  "title": {
    "snippet": "Great Smoky Mountains"
  },
  "description": {
    "snippet": "The Great Smoky Mountains, part of the Appalachian Mountains, span a wide range of elevations"
  },
  "id": {
    "raw": "park_great-smoky-mountains"
  }
}

We’ve determined that users often search by the name of the park.

A great result has just enough descriptive text to tantalize, and then a title to act as a firm anchor.

Such a result would look like so in Result Settings:

Result Settings - Building a fast, rich result.

We only want two fields: title and description. And we only want 100 characters of each, highlighting exact matches.

If a user were to search for "great smoky mountains", the concise result will return, enriched:

{
  "title": {
    "snippet": "<em>Great Smoky Mountains</em>"
  },
  "description": {
    "snippet": "The <em>Great Smoky Mountains</em>, part of the Appalachian Mountains, span a wide range of elevations"
  },
  "id": {
    "raw": "park_great-smoky-mountains"
  }
}

That’s clean.

... And we’ve selected Fallback.

What’s that?

Fallback means that...

If there are no exact matches to highlight but there are somewhat relevant results returned, then the values return raw.

In other words, you’ll receive an HTML escaped snippet with no highlighted values.

Being escaped, the fields require no special handling within your front-end code.

If you do not enable Fallback, then nothing will be returned.

The best way to find your own sweet spot is to experiment.

Maybe your default query is sleek and robust and then you apply deeper querying options across more, larger fields when required?

Not into the UI thing?

Remember that you can:

Enjoy!

Note: Snippets can also be used to sanitize inputs. Check out the Sanitization, Raw or Snippet Guide for more information.