Skip to content

Conversation

@cdarne
Copy link

@cdarne cdarne commented Dec 2, 2025

Summary

Removes the deprecated subTopic feature from webhooks across all packages. The subTopic feature was deprecated in API version 2024-04 and fully removed in 2024-07.

  • Remove ShopifyHeader.SubTopic enum value from lib/types.ts
  • Remove subTopic from webhook type definitions (WebhookHandlerFunction, BaseWebhookHandler, WebhookFields)
  • Remove subTopic validation and header extraction from validate.ts
  • Remove subTopic from webhook callback arguments in process.ts
  • Remove subTopic from GraphQL mutation building in register.ts
  • Remove subTopic from WebhookContext type in both @shopify/shopify-app-remix and @shopify/shopify-app-react-router
  • Remove related tests and documentation

Related

Test plan

  • Build passes for @shopify/shopify-api, @shopify/shopify-app-remix, @shopify/shopify-app-react-router
  • Register tests pass (18/18)
  • TypeScript compilation succeeds

🤖 Generated with Claude Code

The webhook subTopic feature was deprecated in API version 2024-04 and
fully removed in 2024-07. This commit removes all traces of subTopic
from the codebase.

Changes:
- Remove ShopifyHeader.SubTopic enum value
- Remove subTopic from WebhookHandlerFunction, BaseWebhookHandler, and
  WebhookFields types
- Remove subTopic validation and processing logic
- Remove subTopic from GraphQL mutation building
- Remove subTopic from Remix and React Router webhook context
- Remove related tests and documentation

Related to: shop/issues-event-foundations#128
Related PR: Shopify/shopify-dev#65578

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
@cdarne cdarne requested a review from a team as a code owner December 2, 2025 20:22
- Change version bump from minor to major
- Add comprehensive migration guide to changeset
- Add clarifying comment to validate.ts
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant