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.
Overview
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.
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").
Creating Rich Snippets with the Programmable Search Element
Essentially, creating rich snippets involves the following steps:
- Provide structured data in your webpages.
When Programmable Search Engine is indexing your webpages, it recognizes and preserves the metadata.
- 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.
- 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.
Exploring Other Features
Custom Snippets works well with several other Programmable Search Engine features:
- If you want to learn more about changing the order of your results, see Drilling Deeper into Search Results.
- If you want to learn more about what structured data Google supports, see Providing Structured Data.
- If you want to learn more about the Programmable Search Element, see Programmable Search Element documentation.