Skip to main content
Version: v3.x beta

Filter Based on Fields of Nested Objects


You can use the fields of nested objects as well to filter your query results.

For example:

query {
articles(where: { author: { name: { _eq: "Sidney" } } }) {

The behavior of the comparison operators depends on whether the nested objects are a single object related via an object relationship or an array of objects related via an array relationship.

  • In case of an object relationship, a row will be returned if the single nested object satisfies the defined condition.
  • In case of an array relationship, a row will be returned if any of the nested objects satisfy the defined condition.

This is only supported for local relationships, such as relationships between two local database tables. This is not supported for remote relationships, such as remote database relationships or Remote Schema relationships.

Let's look at a few use cases based on the above:

Fetch if the single nested object defined via an object relationship satisfies a condition


Fetch all articles whose author's name starts with "A":

Fetch if nested object(s) exist/do not exist

You can filter results based on if they have nested objects by checking if any nested objects exist. This can be achieved by using the expression {} which evaluates to true if any object exists.

Example where nested object(s) exist:

Fetch all authors which have at least one article written by them:

Example where nested object(s) do not exist:

Fetch all authors which have not written any articles: