Skip to content
  • Documentation >
  • Templating >
  • Queries and controllers >
  • Built-in Query types

Built-in Query types

General Query type parameters

All built-in Query types take the following optional parameters:

  • limit - maximum number of results to return
  • offset - offset for search hits, used for paginating the results
  • sort - sort order
  • filter - additional query filters:
    • content_type - return only results of given content types
    • visible_only - return only visible results (default true)
    • siteaccess_aware - return only results limited to the current SiteAccess root (default true)

For example:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
params:
    query:
        query_type: 'Children'
        parameters:
            content: '@=content'
            filter:
                content_type: ['blog_post']
                visible_only: false
            limit: 5
            offset: 2
            sort: 'content_name asc, date_published desc'
        assign_results_to: items

Sort order

To provide a sort order to the sort parameter, use names of the Sort Clauses. To find them, refer to Sort Clause and the relevant Sort Clause class

Children

The Children Query type retrieves children of the given Location.

It takes location or content as parameters.

1
2
3
4
5
6
params:
    query:
        query_type: 'Children'
        parameters:
            content: '@=content'
        assign_results_to: items

Tip

For an example of using the Children Query type, see List content.

Siblings

The Siblings Query type retrieves Locations that have the same parent as the provided content item or Location.

It takes location or content as parameters.

1
2
3
4
5
6
params:
    query:
        query_type: 'Siblings'
        parameters:
            content: '@=content'
        assign_results_to: items

Tip

For an example of using the Siblings Query type, see Embed related content.

Ancestors

The Ancestors Query type retrieves all ancestors (direct parents and their parents) of the provided Location.

It takes location or content as parameters.

1
2
3
4
5
6
params:
    query:
        query_type: 'Ancestors'
        parameters:
            content: '@=content'
        assign_results_to: items

RelatedToContent

The RelatedToContent Query type retrieves content that is a reverse relation to the provided content item.

Tip

Reverse relations mean that the Query type shows content items that are related to the provided content item. For example, if a blog post contains a link to an article, you can use a RelatedToContent query to find the blog post from the article. To find all relations of a content item (in this example, all content that the blog post is related to), refer to Embed content.

It takes content or field as required parameters. field indicates the Relation or RelationList Field that contains the Relations.

1
2
3
4
5
6
7
params:
    query:
        query_type: 'RelatedToContent'
        parameters:
            content: '@=content'
            field: 'relations'
        assign_results_to: items

GeoLocation

The GeoLocation Query type retrieves content by distance of the location provided in a MapLocation Field.

It takes the following parameters:

  • field - MapLocation Field identifier
  • distance - distance to check for
  • latitude and longitude - coordinates of the location to check distance to
  • (optional) operator - operator to check value against, by default <=
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
params:
    query:
        query_type: 'GeoLocation'
        parameters:
            field: 'location'
            distance: 200
            latitude: '@=content.getFieldValue("location").latitude'
            longitude: '@=content.getFieldValue("location").longitude'
            operator: '<'
        assign_results_to: items

Catalog

The Catalog Query type retrieves products belonging to a catalog.

It takes the following parameters:

  • identifier - identifier of the catalog
1
2
3
4
5
6
params:
    query:
        query_type: 'Catalog'
        parameters:
            identifier: 'promo'
        assign_results_to: products