Set up a search template

Overview

A search template is created in exactly the same way as a regular template, except that the rails are populated with content returned from a search initiated by a client application user.

Setting up a search template

To set up a search template, in Rails Builder:

1. Create a new template and initial layout. (See Create templates)
   Note: the Template name that you define here is the one that the client application must use when Searching using search rails.

2. Add a new rail. (See Add rails to a layout)

3. To add content to the rail, click Add Content. (See Add content to a rail).

4. For each rail section that you want to add (do this only once if you want the rail to consist of a single section):

   1. At the top, hover over Personalised and then click Search.

   2. Under Engine, select the search engine you want to use.

   3. Optionally, in Query, add any additional search terms to be used in the search. For example, if you want the rail to only display series that match the user’s search query (and no other type of content), type type=series.

   4. Optionally, if you want to restrict the search to a specific provider, select the provider in Provider.

   5. Optionally, to restrict the search to content that belongs to a particular genre, select the genre in Genre.

   6. Optionally, to restrict the search to content that features a particular actor, type or select the actor in Actor.

   7. In Number of items, type the number of search results to be included in the rail.

5. Click at the top right of the pane to add the section to the rail.

6. Once you have added all the required sections to the rail, click Save Unsaved Changes.

7. Click Continue.

8. Click Back to Rails to see your new rail.

9. Click Layouts to go back to the layouts view for the template.

10. To enable the layout, click at the top-right of the layout tile and select Set as Default.

Note that you can mix and match different types of section in a rail. For example, you can have one section containing search results and another containing recommendations.

You can also have multiple rails in the template/layout that is used for search. Again, these do not all have to be search-based. For example, you could have two search-based rails, one promotional banner rail, and one recommendation rail.