shopify app deploy blocked by phantom [events]: Required — Partner Dashboard shows no Events feature enabled
Nobody has claimed this yet.
- Dominant language
- TypeScript
- Stars
- 750
- Forks
- 293
- Avg merge
- 3d 20h
- Merged PRs (30d)
- 79
Description
CLI version: reproduced identically on 4.7.0, 4.6.1, 4.0.0, and 3.94.3
Problem
shopify app deploy (and shopify app config validate) fails with:
[events]: Required
even though shopify.app.toml has no [events] section and never has. I checked the Partner Dashboard for this app — there's no mention of "Events" / "Next-Gen Events" anywhere, no toggle, nothing to enable or configure.
Steps to reproduce
- Have an existing app with a
shopify.app.tomlthat has never used[events](just a plain[webhooks]section withapi_versionset, no subscriptions). - Run
shopify app config validate(orshopify app deploy). - Observe:
╭─ error ──────────────────────────────────────────────────────────────────────╮ │ │ │ Validation errors found. │ │ │ │ • [events]: Required │ │ │ ╰──────────────────────────────────────────────────────────────────────────────╯
What I tried
- Confirmed it's not a local-CLI-version issue — reproduced the identical error on
@shopify/cli4.7.0, 4.6.1, 4.0.0, and 3.94.3 (full major-version spread) vianpx @shopify/cli@<version> app config validate. Since the required-field set differs across those releases, this points to the check coming from the Partners backend, not code bundled in the CLI. - Added a minimal
[events]block toshopify.app.toml:
This flips to two contradictory errors:[events] api_version = "2026-07"
So the backend simultaneously demands the section and rejects it as unsupported for this app — no toml content can satisfy both at once.[events.subscription]: Required Unsupported section(s) in app configuration: events
Expected behavior
shopify app deploy should succeed without requiring a section for a feature that isn't enabled for the app/org, or the error message should point at what actually needs enabling instead of a self-contradictory pair of validation errors.
Context
- App has an existing, working
[webhooks]section (api_versionset, no subscriptions configured yet). - Partner Dashboard shows no "Events" (developer preview) toggle or notice for this app.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reproducing the failure with shopify app config validate and shopify app deploy using a shopify.app.toml containing only [webhooks]. Trace the configuration validation entry points and the Partner Dashboard response; done means an app without Events enabled no longer receives the contradictory [events] errors, or the message identifies the required enablement step.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- typescript
- Domain
- backend, cli
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Active
- Clarity
- Needs clarification
- Newbie friendliness
- 42/100