How to query posts by category in Sanity?

7 replies
Last updated: Jan 29, 2026
Hi! First project w/ Sanity and since it seemed easiest (because it was the example in the tutorial πŸ€·β€β™€οΈ) and I thought I could modify it later I chose Blog as a template.I'm doing a site where I'm going to display different categories of handicrafts - with name/title and an image (used Post to set up this).
I've added all the different categories in Category and connected each post to the correct category.
My question is, is it possible to query on category, and how do I do that?
AI Update

Great question! Yes, you can absolutely query posts by category in GROQ. Since you're using the blog template where posts have a category reference, you have a couple of options:

Filtering Posts by Category

The most straightforward approach is to filter posts where the category reference matches a specific category ID:

*[_type == "post" && category._ref == "your-category-id"]

Or if you want to match by the category's slug or title, you can use the reference access operator (->) to dereference the category and check its properties:

*[_type == "post" && category->slug.current == "woodworking"] {
  title,
  mainImage,
  category->{
    title,
    slug
  }
}

This query:

  1. Filters posts where the category's slug is "woodworking"
  2. Returns the post's title and image
  3. Resolves the category reference to include the full category details

Getting All Posts Grouped by Category

If you want to get all your handicraft categories with their associated posts, you can do a reverse reference lookup:

*[_type == "category"] {
  title,
  "posts": *[_type == "post" && references(^._id)] {
    title,
    mainImage
  }
}

This gives you each category with an array of all posts that reference it - perfect for displaying all your handicraft categories with their associated items!

In Your Frontend Code

If you're using Next.js or another framework, you'd typically query like this:

const query = `*[_type == "post" && category->slug.current == $categorySlug] {
  title,
  slug,
  mainImage,
  category->
}`

const posts = await client.fetch(query, { categorySlug: 'woodworking' })

The -> operator is the key here - it "dereferences" the reference, fetching the actual category document instead of just the reference ID. You can use it to both filter by category properties and to include the full category data in your results.

Show original thread
7 replies

Sanity – Build the way you think, not the way your CMS thinks

Sanity is the developer-first content operating system that gives you complete control. Schema-as-code, GROQ queries, and real-time APIs mean no more workarounds or waiting for deployments. Free to start, scale as you grow.

Was this answer helpful?