Search Results in Grid View

A pretty common request I get when working with Search results for content solutions is to display the results as a grid, and not the normal block format we see with the standard search results below. 

Since we have full control over how things are rendered with the display templates, it is pretty easy to alter the formatting now using simple html and javascript to render it as a grid. 

For this example, we are going to assume that the grid format will be applied to all items uniformly.  To do that, we will select a specific display template to use instead of allowing the rules to detect the appropriate template, item by item.  For this example, I’m going to work with a copy of the Item_OfficeDocument.html display template which has the following markup:


The ctx.RenderBody(ctx) line will inject the standard rendered output. You can really structure this with whatever markup suits your requirements. When I need to provide a grid or tabular format I will typically use an unordered list that floats. Here is a simple three column example:

  • _#=ctx.CurrentItem.Title =#_
  • _#=ctx.CurrentItem.DisplayAuthor=#_
  • _#=formattedDate=#_

In this example, you may notice that I also did some formatting the UTC formatted date. This is a good example of how we can manipulate the data as needed.  Below is an example of the grid view.



While this is a simple example that uses only default fields available to all lists and libraries, it is easy to add in additional properties that can be leveraged by your markup. The only real stipulation here is that you will need to make sure that it is a property recognized by the search index. At the top of the document there is property called "ManagedPropertyMapping" which lists the properties that need to be loaded and available for the markup. Here is the default value for the Item_OfficeDOcument template.


To add in a custom property, you simply need to add in the name/value pair. For example:

'Title':'Title','Path':'Path','Description':'Description','EditorOWSUSER':'EditorOWSUSER','LastModifiedTime':'LastModifiedTime','CollapsingStatus':'CollapsingStatus','DocId':'DocId','HitHighlightedSummary':'HitHighlightedSummary','HitHighlightedProperties':'HitHighlightedProperties','FileExtension':'FileExtension','ViewsLifeTime':'ViewsLifeTime','ParentLink':'ParentLink','FileType':'FileType','IsContainer':'IsContainer','SecondaryFileExtension':'SecondaryFileExtension','DisplayAuthor':'DisplayAuthor','ServerRedirectedURL':'ServerRedirectedURL', 'MyProperty':'MyProperty'

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.

%d bloggers like this: