Customizing Results Snippets

This page describes how to customize the result snippets for your own website. To render your customized snippets, you must add structured data to your webpages.

  1. Overview
  2. Creating Rich Snippets with the Programmable Search Element
  3. Exploring Other Features


Programmable Search Engine helps users find the right page by showing them a snippet—a small sample of content that gives search users an idea of what's in the webpage. To learn more about snippets, see the Webmaster Central blog post on the anatomy of a search result. If you do not like the standard snippets created by the Programmable Search Engine algorithm, you can create your own snippets. You can showcase key information—such as image thumbnails, summaries, dates, authorship, ratings, and prices—directly in your snippets. Having the most relevant information in your search results makes the webpages in your site more compelling to your users.

The following figures demonstrate various ways you can customize the snippets in your search results.

Figure 1: Result snippet with rating, price range, and review.

Figure 2: Result snippet with formatting, links, image, and comparative information.

Example of a result with rich snippets shows ratings, prises, and comparisons to other products

Figure 3: Result snippet that includes document types, authors, page views, and comments.

Figure 4: Richly formatted result snippet that provides multimedia access and buttons ("ADD TO CART").

Back to top

Creating Rich Snippets with the Programmable Search Element

Essentially, creating rich snippets involves the following steps:

  1. Provide structured data in your webpages.

    When Programmable Search Engine is indexing your webpages, it recognizes and preserves the metadata.

  2. Fetch that structured data in the search results for your Programmable Search Engine.

    The Programmable Search Engine server can return the search results, along with the structured data in JSON format.

  3. Create a presentation layer to transform the structured data into formatted HTML.

    A presentation layer is a set of code (such as JavaScript, PHP, JSP and ASP) that transforms the raw data into a format that is displayed to the user. In the case of Programmable Search Engine, you can:

    • Use the Programmable Search Element to transform JSON output for presentation to the user.
    • Write your own custom presentation layer that transforms JSON data to HTML that is presented to the end user using Search Element Callbacks

Structured data extraction is documented in more detail in the Structured Data page, and creating a presentation layer with the Programmable Search Element is documented in more detail at the Programmable Search Element page.

Back to top

Exploring Other Features

Custom Snippets works well with several other Programmable Search Engine features: