search mobile facets autocomplete spellcheck crawler rankings weights synonyms analytics engage api customize documentation install setup technology content domains user history info home business cart chart contact email activate analyticsalt analytics autocomplete cart contact content crawling custom documentation domains email engage faceted history info install mobile person querybuilder search setup spellcheck synonyms weights engage_search_term engage_related_content engage_next_results engage_personalized_results engage_recent_results success add arrow-down arrow-left arrow-right arrow-up caret-down caret-left caret-right caret-up check close content conversions-small conversions details edit grid help small-info error live magento minus move photo pin plus preview refresh search settings small-home stat subtract text trash unpin wordpress x alert case_deflection
Swiftype Documentation / tutorials: Customizing Swiftype Visual Styles

Customizing Swiftype Visual Styles

The Swiftype JavaScript embed code injects HTML and CSS into your page to present search results and autocomplete.

You can change the appearance of a few things through your Swiftype dashboard, but for more advanced customizations you will need to override the default CSS that the embed includes. To do this, you can write custom styles either within your site template or a global CSS file that target specific elements in your HTML markup.

Note: To change the style of the Swiftype embed, you will need a working knowledge of HTML and CSS. If that seems daunting, you could consult your friendly neighborhood web nerd or check out free resources on the web, like CSS Basics.

Using your existing search or removing styles

From the installation configuration view in your Swiftype Dashboard, it's possible to define a custom class for your search to attach to. This is beneficial if your site's theme already includes an input field with a custom class, or you'd prefer an unstyled input field.

input field with no CSS

Default styles

The standard code for installing a Swiftype search box is an input field with the st-default-search-input CSS class.

<input type="text" class="st-default-search-input">

search box styles with default CSS

When you use the class st-default-search-input our default styling is automatically applied to the search box. The following CSS examples are based on using the st-default-search-input class.

Adding placeholder text

If you are wanting to add placeholder text to your search box, you can do this with the HTML placeholder attribute. Just add the paceholder attribute to your search input field, like this:

<input type="text" class="st-default-search-input" placeholder="Search this site...">

input field with placeholder text

Changing the size of your search box

You can easily change the size of your search box by adding CSS styling directly (inline) to the input code snippet. Here's an example of an input field with both a width and height value specified.

<input type="text" class="st-default-search-input" style="width: 300px; height: 50px;">

input field different width and height

Adding a submit button to your search box

Who doesn't like buttons? To add a submit button to your search input, you can wrap the input code in a form container element and add a button element. All styling of the submit button is up to you! You can find an example below.

  <input type="text" class="st-default-search-input">
  <button type="submit">Submit</button>

input with submit

Styling your results

In this basic example, we're going to target the .st-ui-type-heading & .st-ui-type-detail classes to change the font and size of the text displayed:

.st-ui-type-heading, .st-ui-type-detail {
  font-size: 15px !important;
    font-family: Times, serif !important;

In the renderings below, the images on the left are examples of an autocomplete dropdown and full result listing with our default CSS styling. The images on the right have our custom style applied.

Autocomplete Results

autocomplete with and without CSS

Full Search Results

results with and without CSS

Fully custom CSS stying (advanced)

If you would like to take total control of the CSS styling and you are comfortable with customizing and writing your own code, you can use the Swiftype jQuery autocomplete and search plugins to fully design your search experience.