---
title: Improved GraphQL errors - Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: 'https://shopify.dev/changelog/improved-graphql-errors'
  md: 'https://shopify.dev/changelog/improved-graphql-errors.md'
metadata:
  effectiveApiVersion: ''
  affectedApi: []
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2019-12-16T13:45:27-05:00'
  postedAt: '2019-10-31T00:00:00-04:00'
  updatedAt: '2024-02-02T10:04:55-05:00'
  effectiveAt: '2019-10-31T00:00:00-04:00'
---

October 31, 2019

Tags:

* API

# Improved GraphQL errors

Errors in GraphQL responses now contain extra metadata under the `extensions` key. The error format follows the [GraphQL specification](https://graphql.github.io/graphql-spec/June2018/#example-fce18).

The most notable metadata is the `code` property which returns the error code. This feature allows you to more easily match on the types of errors without having to match on the full error `message`.

For example:

```graphql
{
  "errors": [
    {
      "message": "Internal error. Looks like something went wrong on our end.",
      "extensions": {
        "code": "INTERNAL_SERVER_ERROR",
        "requestId": "d2f47302-8559-4961-9a5b-3de60172aa29"
      }
    }
  ]
}
```