Directory Templates

Each page within the directory app has its own template to display that page's content.

Where to save template files

Template files will go in a folder that has the same name as the app instance key. For example, if the directory app instance key is "directory" then you would put all of your template files within the directory folder inside the templates folder.

If your theme was called "Custom" then this would be an example folder structure:

  • themes
    • custom
      • theme.json
      • templates
        • home.twig
        • one-column.twig
        • two-column.twig
        • directory
          • categories.twig
          • category.twig
          • home.twig
          • profile.twig
          • profiles.twig
          • search.twig
          • search-results.twig

Directory pages and their templates

Below is the list of directory app pages and the name of the template file that you should create.

App home

The app home page often shows the directory profiles and/or categories.

Template name: home.twig

Categories list

This page shows the list of categories.

Template name: categories.twig

Category detail

This page shows the detail information for an individual category. The profiles assigned to the category are often shown.

Template name: category.twig

Profile detail

This page shows the full details for an individual profile.

Template name: profile.twig

Profile list

This page shows a paginated list of directory profiles.

Template name: profiles.twig


The search page can be used to show the form to search for profiles.

Template name: search.twig

Search results

The search results page can show the results of a directory app search. It can show a paginated list of matching profiles.

Template name: search-results.twig