---
title: Validation - GraphQL Admin
description: A checkout server side validation installed on the shop.
api_version: unstable
api_name: admin
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/unstable/objects/Validation
  md: https://shopify.dev/docs/api/admin-graphql/unstable/objects/Validation.md
---

# Validation

object

Requires `read_validations` access scope.

A checkout server side validation installed on the shop.

## Fields

* block​On​Failure

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

  non-null

  Whether the validation should block on failures other than expected violations.

* enabled

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

  non-null

  Whether the validation is enabled on the merchant checkout.

* error​History

  [Functions​Error​History](https://shopify.dev/docs/api/admin-graphql/unstable/objects/FunctionsErrorHistory)

  The error history on the most recent version of the validation function.

* id

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

  non-null

  Global ID for the validation.

* metafield

  [Metafield](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Metafield)

  A [custom field](https://shopify.dev/docs/apps/build/custom-data), including its `namespace` and `key`, that's associated with a Shopify resource for the purposes of adding and storing additional information.

* metafields

  [Metafield​Connection!](https://shopify.dev/docs/api/admin-graphql/unstable/connections/MetafieldConnection)

  non-null

  A list of [custom fields](https://shopify.dev/docs/apps/build/custom-data) that a merchant associates with a Shopify resource.

* metafields​By​Identifiers

  [\[Metafield\]!](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Metafield)

  non-null

  The metafields associated with the resource matching the supplied list of namespaces and keys.

* shopify​Function

  [Shopify​Function!](https://shopify.dev/docs/api/admin-graphql/unstable/objects/ShopifyFunction)

  non-null

  The Shopify Function implementing the validation.

* title

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

  non-null

  The merchant-facing validation name.

* metafield​Definitions

  [Metafield​Definition​Connection!](https://shopify.dev/docs/api/admin-graphql/unstable/connections/MetafieldDefinitionConnection)

  non-nullDeprecated

***

## Map

### Fields and connections with this object

* <->[ValidationConnection.nodes](https://shopify.dev/docs/api/admin-graphql/unstable/connections/ValidationConnection#returns-nodes)
* {}[ValidationEdge.node](https://shopify.dev/docs/api/admin-graphql/unstable/objects/ValidationEdge#field-ValidationEdge.fields.node)

***

## Queries

* [validation](https://shopify.dev/docs/api/admin-graphql/unstable/queries/validation)

  query

  Validation available on the shop.

* [validations](https://shopify.dev/docs/api/admin-graphql/unstable/queries/validations)

  query

  Validations available on the shop.

***

## \<?>Validation Queries

### Queried by

* \<?>[validation](https://shopify.dev/docs/api/admin-graphql/unstable/queries/Validation)
* \<?>[validations](https://shopify.dev/docs/api/admin-graphql/unstable/queries/ValidationConnection)

***

## Mutations

* [validation​Create](https://shopify.dev/docs/api/admin-graphql/unstable/mutations/validationCreate)

  mutation

  Creates a validation.

* [validation​Update](https://shopify.dev/docs/api/admin-graphql/unstable/mutations/validationUpdate)

  mutation

  Update a validation.

***

## <\~> Validation Mutations

### Mutated by

* <\~>[validation​Create](https://shopify.dev/docs/api/admin-graphql/unstable/mutations/validationCreate)
* <\~>[validation​Update](https://shopify.dev/docs/api/admin-graphql/unstable/mutations/validationUpdate)

***

## Interfaces

* * [Has​Metafield​Definitions](https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/HasMetafieldDefinitions)

    interface

  * [Has​Metafields](https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/HasMetafields)

    interface

  * [Node](https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/Node)

    interface

***

## ||-Validation Implements

### Implements

* ||-[Has​Metafield​Definitions](https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/HasMetafieldDefinitions)
* ||-[Has​Metafields](https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/HasMetafields)
* ||-[Node](https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/Node)