{{ datastore

datastore_item Properties

Field	Type	Description
object_type	string	"datastore_item"
is_valid	True\|False	True if this references a datastore_item or false if the datastore_item is null
guid	guid	The unique identifier for this datastore_item
datastore_guid	text_field
datastore	datastore
name	text_field	The entity name. This field is primarily intended for internal use by website administrators to identify objects.
title	text_field
linked_title	html	A link to the datastore_item if it has a URL, or the escaped title if not.
folder_guid	text_field
folder	folder
has_url	boolean
site_domain_guid	text_field
ssl_mode	text_field
include_in_search	boolean
url	text_field
template_guid	text_field
template	template
canonical_url	url_field
browser_title	text_field
meta_description	textarea_field
meta_robots	textarea_field
keywords	textarea_field
full_url	string	The full URL of the page - including the scheme ("http://", "https://" or just "//"), the domain name, and the path.
visited	true/false	Whether or not the user has visited the datastore_item before in their current session. Note that this will always be false if the user has not allowed session permission (see the Permissions and Personalization documentation).
custom	varies	Each datastore_item includes all of the custom properties defined by the datastore and the template.
tags	tags	The list of tags associated with this datastore_item.
authors	authors	The list of authors associated with this datastore_item.
value	string	Synonymn for guid
output	html	The default output that the datastore_item produces when output directly to the template.
output_in_list	html	The default output that the datastore_item produces when output directly to the template as part of a list.

datastore_items Summary

Contains multiple datastore_items.

datastore_items Properties

Field	Type	Description
object_type	string	"datastore_items"
is_valid	true/false	true if this contains at least one datastore_item
prepended	list of datastore_items	datastore_items that will be listed at the beginning of the items list
fetched	list of datastore_items	The primary list of datastore_items to be included in the items list
appended	list of datastore_items	datastore_items that will be listed at the end of the items list
appended_unique	list of datastore_items	datastore_items that will be listed at the end of the items list, excluding any datastore_items that are already included in either the prepended or fetched lists
items	list of datastore_items	The full list of datastore_items in the proper order and uniqueness, including prepended, fetched, and appended datastore_items
size	number	The total number of items in the list of items, including prepended, fetched, and appended datastore_items
limit	number	The maximum number of datastore_items that could have been fetched dynamically from the database
start	number	The 1-based index of the first datastore_item that was (or would have been) dynamically fetched from the database
page	number	The 1-based index of the first "page" of datastore_items that could have been fetched dynamically from the database - as determined by the start and limit properties
total_count	number	The total number of datastore_items in the database that matched the provided filter parameters when fetching the list of fetched datastore_items
total_pages	number	The total number of "pages" of results that matched the provided filter parameters when fetching the list of fetched datastore_items - as determined by the total_count and limit properties
output	html	The default output that the datastore_items will produce when it is output directly to the template - using the "output_in_list" property of each datastore_item in the items list

Methods

{% datastore_item %}

Fetch a single datastore_item.

{% datastore_item
[var|set|assign] new_variable_name
 
Specify a variable name in order to save the datastore_item to a variable. If not specified the datastore_item 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 datastore_item will be output directly to the template.
 = 
datastore_item|guid|string
%}

{% datastore_items %}

Fetch a list of datastore_items.

{% datastore_items
[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:datastore_item|datastore_items|guid|string
 
Prepend the specified datastore_items before the fetched results. All prepended input will be returned in the same order that it is input.
append:datastore_item|datastore_items|guid|string
 
Append the specified datastore_items after the fetched results. All appended input will be returned in the same order that it is input.
exclude:datastore_item|datastore_items|guid|string
 
Prevent the specified datastore_items from being included in the fetched results. Has no affect on prepended and appended datastore_items
exclude_prepended:true
 
Specifically exclude all prepended datastore_items 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 datastore_items 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 datastore_items. The "limit" may be automatically lowered to only fetch the maximum number of datastore_items 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".
filter:string
 
Only return datastore items that match the given string filter
has_url:boolean
 
Filter results to only return datastore items for which has_url exactly matches the specified value.
datastore:datastore|datastores|guid|string
 
Only return datastore items with one of these datastores
template:template|templates|guid|string
 
Only return datastore items with one of these templates
include_in_search:boolean
 
Filter results to only return datastore items for which include_in_search exactly matches the specified value.
site_domain_guid:guid
 
Filter results to only return datastore items for which site_domain_guid exactly matches the specified value.
ssl_mode:string
 
Filter results to only return datastore items for which ssl_mode exactly matches the specified value.
query:dictionary
 
Filter results to return datastore items that satisfies query.
tag:tag|tags|guid|string
 
Only return datastore items with one of these tags
author:author|authors|guid|string
 
Only return datastore items with one of these authors
folder:folder|folders|guid|string
 
Only return datastore items with one of these folders
date_created_start:datetime
 
Filter results to return datastore items for which date_created is greater than or equal to date_created_start.
date_created_end:datetime
 
Filter results to return datastore items for which date_created is less than or equal to date_created_end.
start:1
 
Set the 1-based index of the first datastore_item to fetch.
page:1
 
Automatically calculate the first datastore_item 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 datastore_items 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 datastore_items.

By default results will be sorted by relevance if there is a filter string and date_created (the date the item was first published) desc (newest first) if not.

Other Options include:

Name
Title
URL
BrowserTitle
relevance (based on which field matches the given filter and where in the field the match is found. When sorting by relevance sort_direction is irrelevant)
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)
custom (You may specify a custom datastore field to sort by)
sort_direction:"desc"
 
Specify whether the fetched results should be sorted in asc (ascending) or desc (descending) order.
numeric_sort:true
 
If sorting by a custom field, the results will be sorted alphabetically by default unless you specify numeric_sort:true.
%}

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")

Marketpath templates have the ability to query datastores in unique and powerful ways. Dive into the advanced topic of liquid datastore queries.