{{ template }}

Fetch a single template.

{% template
[var|set|assign] new_variable_name
 
Specify a variable name in order to save the template to a variable. If not specified the template will be output to the template instead. The variable will be saved using the "var" behavior unless "set" or "assign" are specified.
output_to_template
 
If included, the template will be output directly to the template.
 = 
template|guid|string
%}

Fetch a list of templates.

{% templates
[var|set|assign] new_variable_name
 
Specify a variable name in order to save the results to a variable. If not specified the results will be output to the template instead. The variable will be saved using the "var" behavior unless "set" or "assign" are specified.
output_to_template
 
If included, the results will be output directly to the template.
 = 
prepend:template|templates|guid|string
 
Prepend the specified templates before the fetched results. All prepended input will be returned in the same order that it is input.
append:template|templates|guid|string
 
Append the specified templates after the fetched results. All appended input will be returned in the same order that it is input.
exclude:template|templates|guid|string
 
Prevent the specified templates from being included in the fetched results. Has no affect on prepended and appended templates
exclude_prepended:true
 
Specifically exclude all prepended templates from the fetched results. If "unique:true" is specified this is the default behavior, although you may also specify "exclude_prepended:false" to allow any prepended items to be fetched along with other results anyway.
exclude_appended:true
 
Specifically exclude all appended templates from the fetched results. This is false by default - even if "unique:true" is specified - so that results are returned in the proper order.
unique:true
 
If set to true, each of the resulting lists (prepended, fetched, appended, and items) will be unique, although there may be duplicates between the prepended, fetched, and appended lists. The "items" list will include objects in the order in which they appear - with prepended items first, then fetched items, then appended items.
max_size:25 
 
If specified, then the "items" list will only include up to the specified number of templates. The "limit" may be automatically lowered to only fetch the maximum number of templates that will be included in "items" following prepended items. Note that this may also impact both the "page and "total_pages" values. In order to use pagination with a list loaded using "max_size" use "start" instead of "page" and "limit".
template_type:string
 
Filter results to only return templates for which type exactly matches template_type.
global_type_id:string
 
Filter results to return templates that accept global_type_id.
path:string|list of strings
 
Only return templates with one of these paths.
date_created_start:datetime
 
Filter results to return templates for which date_created is greater than or equal to date_created_start.
date_created_end:datetime
 
Filter results to return templates for which date_created is less than or equal to date_created_end.
start:1
 
Set the 1-based index of the first template to fetch.
page:1
 
Automatically calculate the first template to fetch based on both of the "limit" and the 1-based "page" value. Ignored if "start" is set.
limit:25
 
Defines the maximum number of templates to be fetched. If not included, this will default to 10. Note that if "max_size" is specified then "limit" may be automatically lowered even if specified.
sort_by:"date_created"
 
Specify which field to sort the fetched results by. Has no affect on prepended or appended templates.

By default results will be sorted by date_created (the date the item was first published) desc (newest first).

Other Options include:

Name
date_created (Equivalent to the date you first published this item. Unpublishing and republishing the item resets date_created to the current date)
random (By default using random sorting prevents fast caching of the page. Setting "cache_random:true" overrides this behavior and allows the page to be fast-cached anyway)
sort_direction:"desc"
 
Specify whether the fetched results should be sorted in asc (ascending) or desc (descending) order.
%}

If you do not include any filters or inputs other than prepended items, appended items, or max_size, then no additional items will be fetched. If you wish to fetch all items you must include at least one additional input (ie: "start:1")