How to Query Nested Objects in GraphQL: Syntax and Examples

In GraphQL, you query nested objects by specifying the nested fields inside curly braces within the parent field's selection set using {}. This lets you fetch related data in one request by nesting queries for child objects inside their parent objects.

Syntax

To query nested objects in GraphQL, you write the parent field followed by curly braces {} containing the nested fields you want. Each nested object can have its own set of fields inside its own curly braces.

• Parent field: The main object you want data from.
• Nested fields: Fields inside the parent that are objects themselves.
• Curly braces: Used to group fields and nested queries.

graphql

query {
  user(id: "1") {
    id
    name
    posts {
      id
      title
      comments {
        id
        content
      }
    }
  }
}

Example

This example queries a user by ID, fetching the user's id and name. It also fetches the user's posts, and for each post, it fetches the id, title, and nested comments with their id and content. This shows how to get related nested data in one query.

graphql

query {
  user(id: "1") {
    id
    name
    posts {
      id
      title
      comments {
        id
        content
      }
    }
  }
}

Output

{
  "data": {
    "user": {
      "id": "1",
      "name": "Alice",
      "posts": [
        {
          "id": "101",
          "title": "GraphQL Basics",
          "comments": [
            { "id": "1001", "content": "Great post!" },
            { "id": "1002", "content": "Very helpful." }
          ]
        },
        {
          "id": "102",
          "title": "Advanced GraphQL",
          "comments": []
        }
      ]
    }
  }
}

Common Pitfalls

Common mistakes when querying nested objects include:

• Forgetting to include nested fields inside curly braces, which causes errors or incomplete data.
• Requesting fields that do not exist on the nested object, leading to errors.
• Not understanding the schema structure, so nesting queries incorrectly.

Always check the GraphQL schema to know which fields are objects and what nested fields they support.

graphql

query {
  user(id: "1") {
    id
    name
    posts
  }
}

# Wrong: 'posts' is an object list, so you must specify fields inside it.

query {
  user(id: "1") {
    id
    name
    posts {
      id
      title
    }
  }
}

# Correct: Nested fields inside 'posts' are specified.

Quick Reference

Concept	Description	Example
Parent Field	The main object you query	user(id: "1")
Nested Object	An object field inside parent	posts
Nested Fields	Fields inside nested object	id, title, comments
Curly Braces	Group fields and nested queries	{ id name posts { id title } }
Error Cause	Missing nested fields inside object	posts (without { ... })

Key Takeaways

Use curly braces to nest fields inside parent objects in GraphQL queries.

Always specify which fields you want from nested objects to get data.

Check the GraphQL schema to understand which fields are nested objects.

Avoid requesting object fields without specifying their nested fields.

Nested queries let you fetch related data in a single request efficiently.