groq

GROQ tagged template literal

This module exports a single function that can be called with an ES2015 template string to signal that it represents a GROQ-query.

The result will be the exact same string as the input, - this is currently helpful for getting syntax highlighting in editors, but in the future it might also parse and validate queries, strip unncessary whitespace and similar.

Pairs well with vscode-sanity!

Installing

npm install --save groq

Usage

import groq from 'groq'

const query = groq`*[_type == 'products'][0...10]`

Automatic type inference

If you are using @sanity/codegen you can use defineQuery instead of groq to get type inference out of the box:

import {defineQuery} from 'groq'

const query = defineQuery(`*[_type == 'products'][0...10]`)

In the future we might merge defineQuery with groq, but this is currently not 100% supported by TypeScript.

What is Sanity? What is GROQ?

Sanity is a real-time content infrastructure with a scalable, hosted backend featuring a Graph Oriented Query Language (GROQ), asset pipelines and fast edge caches.

To get started with Sanity, please head over to our getting started guide

License

MIT-licensed. See LICENSE.

Changelog

4.11.0 (2025-10-21)

Features

• sanity: add UI control for toggling visibility of inline changes (2f71623) by Ash ([e-mail])
• scheduled drafts uses sanity.config property proper to disable (#10635) (50a2e6e) by Jordan Lawrence ([e-mail])

Bug Fixes

• cli: pipe stderr when installing dependencies (#10839) (704a357) by Bjørge Næss ([e-mail])
• core: mention options in tasks comments showing as unauthorized (#10832) (6c34de9) by Pedro Bonamin ([e-mail])
• deps: Update CodeMirror (#10876) (2a973f2) by renovate[bot] (29139614+renovate[bot]@users.noreply.github.com)
• deps: update dependency @portabletext/to-html to v3 (#10882) (bbadd73) by renovate[bot] (29139614+renovate[bot]@users.noreply.github.com)
• deps: update dependency @sanity/client to ^7.12.0 (#10838) (3250d26) by renovate[bot] (29139614+renovate[bot]@users.noreply.github.com)
• deps: update dependency @sanity/comlink to ^3.1.1 (#10880) (3ab3368) by renovate[bot] (29139614+renovate[bot]@users.noreply.github.com)
• deps: update dependency @sanity/insert-menu to v2.1.0 (#10881) (43d06fe) by renovate[bot] (29139614+renovate[bot]@users.noreply.github.com)
• deps: update dependency @sanity/mutate to ^0.14.0 (#10837) (0d5e3cb) by renovate[bot] (29139614+renovate[bot]@users.noreply.github.com)
• deps: update dependency @sanity/presentation-comlink to ^1.0.33 (#10870) (6e450a6) by renovate[bot] (29139614+renovate[bot]@users.noreply.github.com)
• deps: update dependency framer-motion to ^12.23.24 (#10877) (fd13c36) by renovate[bot] (29139614+renovate[bot]@users.noreply.github.com)
• deps: update dependency groq-js to ^1.20.0 (#10852) (ae0f0c7) by renovate[bot] (29139614+renovate[bot]@users.noreply.github.com)
• deps: update dependency react-rx to ^4.2.2 (#10879) (eae61c8) by renovate[bot] (29139614+renovate[bot]@users.noreply.github.com)
• deps: update dependency xstate to ^5.23.0 (#10872) (41d75ca) by renovate[bot] (29139614+renovate[bot]@users.noreply.github.com)
• deps: Update portabletext (#10851) (0562b47) by renovate[bot] (29139614+renovate[bot]@users.noreply.github.com)
• fix issue where publishing a release with drafts disabled would lead to the draft perspective (#10833) (ad2adb7) by RitaDias ([e-mail])
• issues where switching date that didn't mirror the local timezone would have issues with the hours / picked dates (#10830) (e7289bd) by RitaDias ([e-mail])
• published document uses the draft document's title (#10827) (6c81fa3) by Jordan Lawrence ([e-mail])
• sanity: do not compute inline diff using comparison value if there is no upstream version (7a76727) by Ash ([e-mail])
• sanity: stale read-only styles rendered for StringInputPortableText (be29073) by Ash ([e-mail])

Similar packages

Other packages similar to groq

graphql

GraphQL is a query language for APIs and a runtime for executing those queries by using a type system you define for your data. Unlike GROQ, which is designed for querying JSON documents, GraphQL is more versatile and can be used to query various types of data sources.

jsonpath

JSONPath is a query language for JSON, similar to XPath for XML. It allows you to navigate and query JSON documents. While JSONPath is more focused on navigating JSON structures, GROQ provides more advanced querying capabilities like filtering, ordering, and projections.

lodash

Lodash is a JavaScript utility library that provides functions for common programming tasks, including querying and manipulating JSON objects. While Lodash is not a query language, it offers methods that can achieve similar results to GROQ queries through its utility functions.