---
title: validationUpdate - GraphQL Admin
description: Update a validation.
api_version: 2025-10
api_name: admin
type: mutation
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/latest/mutations/validationUpdate
  md: https://shopify.dev/docs/api/admin-graphql/latest/mutations/validationUpdate.md
---

# validation​Update

mutation

Requires `write_validations` access scope.

Update a validation.

## Arguments

* id

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

  required

  The ID representing the validation to update.

* validation

  [Validation​Update​Input!](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ValidationUpdateInput)

  required

  The input fields to update a validation.

***

## Validation​Update​Payload returns

* user​Errors

  [\[Validation​User​Error!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/ValidationUserError)

  non-null

  The list of errors that occurred from executing the mutation.

* validation

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

  The updated validation.

***

## Examples

* ### validationUpdate reference

## Mutation Reference

```graphql
mutation validationUpdate($validation: ValidationUpdateInput!, $id: ID!) {
  validationUpdate(validation: $validation, id: $id) {
    userErrors {
      field
      message
    }
    validation {
      # Validation fields
    }
  }
}
```

## Input

```json
{
  "validation": {
    "enable": true,
    "blockOnFailure": true,
    "metafields": [
      {
        "id": "gid://shopify/<objectName>/10079785100",
        "namespace": "<your-namespace>",
        "key": "<your-key>",
        "value": "<your-value>",
        "type": "<your-type>"
      }
    ],
    "title": "<your-title>"
  },
  "id": "gid://shopify/<objectName>/10079785100"
}
```

##### Variables

```
{
  "validation": {
    "enable": true,
    "blockOnFailure": true,
    "metafields": [
      {
        "id": "gid://shopify/<objectName>/10079785100",
        "namespace": "<your-namespace>",
        "key": "<your-key>",
        "value": "<your-value>",
        "type": "<your-type>"
      }
    ],
    "title": "<your-title>"
  },
  "id": "gid://shopify/<objectName>/10079785100"
}
```

##### Schema

```
input ValidationUpdateInput {
  enable: Boolean
  blockOnFailure: Boolean
  metafields: [MetafieldInput!]
  title: String
}

input MetafieldInput {
  id: ID
  namespace: String
  key: String
  value: String
  type: String
}
```