Quick Start Beginner Tutorial

Template Overview What is JSON? View JSON Data Templating Basics Using Git

Template Configuration Layouts & Regions Template Partials Menus & Navigation Folders & Indexes Collections Static Pages

What is JSON-T? JSON-T Directives JSON-T Predicates JSON-T Formatters JSON-T Helpers JSON-T System Variables

Open Block Field Navigation Tag Category Tag Custom Query Tag

Custom JavaScript Image Loader

Local Development Custom Post Types Template Annotations Style Editor Error Reporting URL Queries

Template Configuration

The template configuration file (template.conf) contains template meta data (template name, author), defines page layouts, navigation areas, and the stylesheet loading order. All .conf files are written in the JSON format.

Example Template Configuration File (template.conf)

{
  "name" : "Template Name",
  "author" : "Author Name",

  "layouts" : {
    "default" : {
      "name" : "Default",
      "regions" : [ "site" ]
    }
  },

  "navigations" : [ {
      "title" : "Main Navigation",
      "name" : "mainNav"
  }, {
      "title" : "Secondary Navigation",
      "name" : "secondaryNav"
  } ],

  "stylesheets" : [ "global.less", "typography.less" ]
}

Configuration Options

name

The name of the template. Displayed in the Template and Developer tabs. (Required)

author

The author of the template. Displayed in the Template and Developer tabs. (Required)

layouts

Site layouts that consist of one or more regions. Defines the overall HTML markup. See Layouts & Regions. (Required: default layout must be defined)

layouts > name

The name of the layout option as it appears in the user-editable layout select field.

layouts > regions

List of region files to combine into layout (in the order they should be combined).

navigations

Configures the top level navigation sections visible in the Navigation section of the interface. See Menus & Navigation.

navigations > title

The name of the layout option as it appears in the user-editable layout select field.

navigations > name

The navigation ID. Used to access navigation data in navigation tags and elsewhere.

stylesheets

List of your stylesheet. Stylesheets will be compiled into site.css following the ordering here.

NOTE: If you add a file named reset.css to the /styles/ folder it will automatically get added to the top of the site.css file. It should not be listed in the "stylesheets" variable in template.conf.