{
  "slug": "shopify-cli-adds-app-execute-and-app-bulk-commands-fd5fc939230c",
  "title": "Shopify CLI adds app execute and app bulk commands",
  "tools": [
    "shopify"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-02-11T10:07:19.000Z",
  "announced_at": "2026-02-11T10:07:19.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When you’re working in a Shopify app and need to query the Admin API, run `shopify app execute` from the app directory with a GraphQL query and, optionally, a store domain. For large data sets, use `shopify app bulk execute` instead.",
    "examples": [
      "shopify app execute --query '<GraphQL query>' [--store <store.myshopify.com>]",
      "shopify app bulk execute --watch --query '<bulk GraphQL query>' [--store <store.myshopify.com>]"
    ],
    "gotchas": [
      "Version: 3.90.1",
      "--query <value> (required): GraphQL query or mutation as a string; use either this or `--query-file`.",
      "--query-file <value> (required): Path to a file containing the GraphQL query or mutation; mutually exclusive with `--query`.",
      "--store <value>: Store’s myshopify.com domain. The app must be installed there; if omitted, the CLI prompts for a store. The guide says the default is the last-used dev store.",
      "--variables <value>: GraphQL variable values in JSON format; mutually exclusive with `--variable-file`.",
      "--variable-file <value>: Path to a JSON file containing GraphQL variables; mutually exclusive with `--variables`.",
      "--version <value>: Admin API version; defaults to the latest stable version.",
      "--watch: For `app bulk execute`, wait for the bulk operation results before exiting; defaults to false.",
      "Prerequisite: Run the command from the root of the app directory. Shopify’s guide requires Shopify CLI, the necessary API access scopes, and the app installed on the store.",
      "Prerequisite: The guide currently says to install the latest Shopify CLI; it does not give a minimum CLI version."
    ]
  },
  "why_it_matters": "Run an Admin API query while working on a Shopify app.",
  "sources": [
    "https://github.com/Shopify/cli/releases/tag/3.90.1",
    "https://shopify.dev/docs/apps/build/apis/graphql-admin/api-exploration/admin-cli-app-execute",
    "https://shopify.dev/docs/api/shopify-cli/app/app-execute",
    "https://shopify.dev/docs/api/shopify-cli/app/app-bulk-execute"
  ],
  "rank": 0.9605,
  "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-f085b72cdb0a9701-0:gate",
    "evidence_hash": "8832425da6f261c041e7334e235fc376b182949dc6c05f4179250f0de35fb223"
  },
  "review": {
    "draft_hash": "ab91f32a1d52d10df525cfae5b16c9ffa50cbe61b35e04507343551cf89dad8b",
    "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.96 >= 0.9; 2 needed) and Jev gave 0.69 (>= 0.6 needed)."
  }
}