Fetching multiple model items

When you want to retrieve content items from multiple models, you can use the ContentItems query.

Include the __typename argument to see which model the returned content items belong to. You can make your query more specific by including the necessary arguments for each model. Please see the example below.

query {
    ContentItems( limit : 30 ) {
        items {
            __typename
            ... on Post {
                _id,
                _slug
            }
        }
    }
}

Query only content items from specific models

To narrow query results to specific models, you can include a filter on its name by using the _typename_any argument.

The following query retrieves all content items from the Post and Page models:

query {
  ContentItems( where : { _typename_any : [ "Post", "Page" ] } ) {
    items {
        ... on Post {
            _id,
            _slug
        }
        ... on Page {
            _id,
            _slug
        }
    }
  }
}

Additionally, you can also use multiple filters to retrieve only specific content items from a model. Check out the Filtering options reference for more details.

Arguments

The following arguments are available or required when querying multiple items:

Filtering multi-model items

To filter multi-model items, include the where argument in your query, followed by the relevant filter types for the fields on your model. Check out the full list of the available filters below.

Query by customer relation

The engagement your customers have with your content items can be tracked using the Prepr Tracking Code. If customers are allowed to bookmark, subscribe or like content items, this filter allows you to fetch the content items based on the customer event, such as liked.

Read more about Customer Relation filtering.

Sorting multi-model items

When fetching multiple content items at once, you can define the order of returned records by using the sort argument. This can be particularly useful when working with large datasets or complex queries. It helps to quickly locate specific records in your project.

You can order results in ascending or descending order by specific system fields. More information can be found below.

Sorting by common attributes

It's possible to sort by the common attributes created, changed and published dates in ascending or descending order. The current values for sorting those fields are created_on_ASC, created_on_DESC, changed_on_ASC, changed_on_DESC, publish_on_ASC, publish_on_DESC.

type Query {
  ContentItems( sort : publish_on_DESC ) {
    items {
        _id,
        title
    }
  }
}

Sorting by popularity

This option will sort the content items on descending order by the number of views.

type Query {
  ContentItems( sort : popular ) {
    items {
        _id,
        title
    }
  }
}

Default ordering

If you don't pass an explicit order value the returned content items are ordered by publish_on_DESC. This means that the most recently published content item appear at the top of the list.