Alert This post is over a year old, some of this information may be out of date.

Things to check when something went wrong with your display template

Show image Default message when there is a problem with your template
Default message when there is a problem with your template

I receive a lot of questions about why display templates are not working or why managed properties do not contain a value. Most of the times the solution is similar to what has been already asked before, so I thought of writing this down in order that it can help everyone with similar issues.

For this article, I have gathered the most asked question. Feel free to suggest others via the comments.

I downloaded the display template from the GitHub SPCSR repo and template is not working

This is actually a common one. It has nothing to do with the template in fact, but the way how you download the files from GitHub.

When you download the file via right-click > save link as (or save target as). The template will not work because it will also include the HTML of the GitHub page.

Show image Display template contains content from GitHub
Display template contains content from GitHub

Solution

The best way to get the display template is to open it on GitHub so that you can see the file content.

Show image Click on the raw button
Click on the raw button

Once you opened it, you will have a Raw button at the top. Click on that button and copy/paste the code to a new HTML file.

Show image Raw file content
Raw file content

You can also right-click on this button and save the link as an HTML file.

Important: if you do this in Internet Explorer, it will create a txt file. So be sure that you change this to HTML.

Why is my display template is not displayed in the dropdown of available display templates?

There are a couple of reasons why a template would not appear in the dropdown list. Check each of the solutions in order to know to what it was related.

Solutions

  • Be sure that you published the display template. The template only becomes available when there is at least one major version;
  • If you have published it already and it still does not appear, try to re-publish it. I know it sounds stupid, but in most cases this works;
  • Check that you did not accidently set the template as hidden (uncheck the hidden template checkbox);
Show image Hidden template checkbox
Hidden template checkbox
  • Check if the target control type is set to the web part in which you want to use it:
Show image Specify the target control type
Specify the target control type

Sorry, something went wrong. Template not found or has syntax errors

In 99 percent of the cases, this error is related to a bug in the code. That one percent will probably be related to someone that has deleted or moved the template. So if that is the case, you will have to put it back in place.

Here is an example of such an error:

Show image Template not found or has syntax errors
Template not found or has syntax errors

Solution

As the error does not say much, the best way to solve it is to open your browser developer tools (f12) and go to the console first. In the browser console, check if there is an error logged. In most cases when you wrote a bug in the display template, you will see it in the console like in this example:

Show image Check browser console
Check browser console

If you click on the file link, the developer tools load the file and shows you where the error occurs:

Show image Most of the time the develop tools tell you the error
Most of the time the develop tools tell you the error

What if you do not see any errors in the console?

Something else might be going on. Try to set a breakpoint in the JS template and debug the code to see where the error occurs.

Show image Debug your display template
Debug your display template

My managed property value is empty or null, but I am sure the content is indexed

If you are adding new property mappings to you display templates, it can happen that you retrieve empty values. Here are a couple of solutions that can help you solve it.

Solutions

  • If you are still developing the template, check if the template is at least checked-in. If it is not checked-in, your web part will not pick up the latest managed property changes;
  • If the template is ready for production, check that you published the latest version of your display template.
  • Use the SharePoint Search Query Tool (https://sp2013searchtool.codeplex.com). Specify the managed properties that you want to retrieve and perform the same query. Check if you retrieve managed property values via this tool.
    • If this is the case, the problem can be related to the template.
    • When you do not retrieve any values, it could be related to the content which might not be indexed yet.
  • When you introduced a new managed property in a display template associated with a result type, you will have to go to the result types page and do a property sync:
    Show image Property sync message
    Property sync message
Show image Property sync message when updated
Property sync message when updated
  • When people result managed properties get returned as empty like AccountName, CellPhone, …. You have to add the following managed properties to your display template mappings: ServiceApplicationID and UserProfile_GUID.

Info: Read more about the people managed property mappings issue here: Important managed properties for rendering people results.

Watch out when downloading templates from SharePoint Online

You have to watch out when you download a display template via the download a copy ECB menu action in SharePoint Online.

Show image Download a copy of the file
Download a copy of the file

When you do this, additional content gets added to your template at the bottom of the file:

Show image Additional content that gets added
Additional content that gets added

This additional content has to be removed from the template before upload it to SharePoint again. If you do not do this, it generates an error in the JS template.

Info: this additional data gets added by IIS. Microsoft is already aware of this.

Comments

Back to top