---
title: ShopifyqlQueryResponse - GraphQL Admin
description: A response to a ShopifyQL query.
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyqlQueryResponse
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyqlQueryResponse.md
api_name: admin
api_type: graphql
type: object
---

# Shopifyql​Query​Response

object

Requires `read_reports` access scope.

A response to a ShopifyQL query.

## Fields

* analytics​Targets

  [\[Analytics​Target!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/AnalyticsTarget)

  non-null

  A list of analytics targets that match the ShopifyQL query. For target gauge queries, returns the matching target if one exists. For `COMPARE TO targets` queries, returns matching targets for visualized metrics in `VISUALIZE` order. Returns an empty list when no targets match or the ShopifyQL query cannot be matched. Query `parseErrors` to detect invalid ShopifyQL.

* parse​Errors

  [\[String!\]!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  non-null

  A list of parse errors, if parsing fails.

* parse​Warnings

  [\[String!\]!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  non-null

  A list of non-fatal parse warnings, such as use of a deprecated field. Unlike `parseErrors`, warnings are returned alongside results.

* table​Data

  [Shopifyql​Table​Data](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyqlTableData)

  The result in a tabular format with column and row data.

***

## Map

No referencing types

***

## Queries

* [shopifyql​Query](https://shopify.dev/docs/api/admin-graphql/latest/queries/shopifyqlQuery)

  query

  Executes a [ShopifyQL query](https://shopify.dev/docs/apps/build/shopifyql) to analyze store data and returns results in a tabular format.

  The response includes column metadata with names, data types, and display names, along with the actual data rows. If the query contains syntax errors, then the response provides parse error messages instead of table data.

  Read the [ShopifyQL reference documentation](https://shopify.dev/docs/api/shopifyql) for more information on how to write ShopifyQL queries.

  * query

    [String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

    required

    ### Arguments

    A ShopifyQL query string following the [ShopifyQL syntax](https://shopify.dev/docs/api/shopifyql). Queries must include `FROM` to specify the data source (such as `sales`, `orders`, or `customers`) and `SHOW` to select metrics and dimensions. Example: `FROM sales SHOW total_sales TIMESERIES month SINCE -12m`.

  ***

***

## ShopifyqlQueryResponse Queries

### Queried by

* [shopifyql​Query](https://shopify.dev/docs/api/admin-graphql/latest/queries/shopifyqlQuery)