gatsbyjs/gatsby · error · Error

111000

111000

Error message

Couldn't initiate bulk operation query

What it means

makeSourceFromOperation maps Shopify bulkOperationRunQuery userErrors into a panic; this generic message is emitted alongside/before the per-error field: message strings. It means Shopify refused to even initiate the bulk query — typically an invalid query document or invalid variables for the bulk API.

Source

Thrown at packages/gatsby-source-shopify/src/source-from-operation.ts:45

    const operationTimer = reporter.activityTimer(
      `source ${lastBuildTime ? `changed ` : ``}shopify ${op.name}`
    )

    operationTimer.start()

    try {
      if (isPriorityBuild(pluginOptions)) {
        await cancelOperationInProgress()
      } else {
        await finishLastOperation()
      }

      const {
        bulkOperationRunQuery: { userErrors, bulkOperation },
      } = await op.execute()

      if (userErrors.length) {
        reporter.panic(
          userErrors.map(e => {
            const msg = e.field
              ? `${e.field.join(`.`)}: ${e.message}`
              : e.message

            return {
              id: errorCodes.bulkOperationFailed,
              context: {
                sourceMessage: `Couldn't initiate bulk operation query`,
              },
              error: new Error(msg),
            }
          })
        )
      }

      const resp = await completedOperation(bulkOperation.id)

View on GitHub (pinned to e85d62f177)

Solutions

1. Fix the bulk-operation query/variables listed in the accompanying userError details
2. Ensure the query is eligible for Shopify bulk operations
3. Check API credentials and scopes

When it happens

Trigger: Thrown at packages/gatsby-source-shopify/src/source-from-operation.ts:45 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of gatsbyjs/gatsby@e85d62f177 (2026-08-26). Data as JSON: /api/errors/327a1b4970fb0e8c. Report an issue: GitHub.