{
  "slug": "shopify-app-validate-checks-app-and-extension-configuration-c01622f103f5",
  "title": "shopify app validate checks app and extension configuration",
  "tools": [
    "shopify"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-04-02T16:09:20.000Z",
  "announced_at": "2026-04-02T16:09:20.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When you need to check an app configuration and extension configurations against their schemas, run `shopify app validate` with the selected app context; use the listed flags to choose the app directory, config, or client ID, or reset settings.",
    "examples": [
      "shopify app validate [--client-id <client-id> | -c <config>] [--no-color] [--path <app-directory>] [--reset] [--verbose]"
    ],
    "gotchas": [
      "Version: 3.93.0",
      "--client-id <value>: Client ID of your app.",
      "-c, --config <value>: Name of the app configuration; environment variable: SHOPIFY_FLAG_APP_CONFIG.",
      "--path <value>: Path to your app directory.",
      "--reset: Reset all your settings.",
      "--no-color: Disable color output.",
      "--verbose: Increase output verbosity.",
      "Prerequisite: Shopify CLI installed. General CLI requirements: Node.js 22.12 or higher, a Node.js package manager (npm, Yarn 1.x, or pnpm), and Git 2.28.0 or higher.",
      "The command links to the user's app using the linked app context.",
      "Docs conflict: Current Shopify docs use `shopify app config validate`; the 3.93.0 release documentation specifies `shopify app validate`. Current docs also list flags absent from 3.93.0. Used the versioned 3.93.0 README for the card’s command and flags."
    ]
  },
  "why_it_matters": "Check an app repository's configuration and extension TOML files for schema errors without running `dev` or `deploy`.",
  "before": "Run `shopify app dev` or `shopify app deploy` to trigger configuration validation as part of those workflows.",
  "sources": [
    "https://github.com/Shopify/cli/releases/tag/3.93.0",
    "https://github.com/Shopify/cli/pull/6934",
    "https://github.com/Shopify/cli/blob/3.93.0/packages/cli/README.md",
    "https://shopify.dev/docs/api/shopify-cli"
  ],
  "rank": 0.97033,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v2+judge-v2x3+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "wave2a-20261017",
    "verdict_id": "wave2a-20261017:wave2a-20261017-cdfd5540a3039993-1:gate",
    "evidence_hash": "371fcbd8ee31c7919fbf7d234c61ec77f6fa96f5a5eeeb318b61b04b6498f41e"
  },
  "review": {
    "draft_hash": "d8a6941c1034d63d9dbce4bad06eee6f0c1bc1569a405cc921565c9d83c2e29d",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "wave2a-20261017:gate",
    "reason": "3 of 3 judge runs approved with p_yes >= 0.9 (mean 0.97 >= 0.9; 2 needed) and Jev gave 0.84 (>= 0.6 needed)."
  }
}