Saleor App

Guide for building apps that extend Saleor via webhooks and the GraphQL API. Framework-agnostic protocol documentation with Next.js examples using @saleor/app-sdk.

When to Apply

• Defining an app manifest or registering webhooks
• Handling async/sync webhook events from Saleor
• Authenticating requests (registration handshake, JWT, signature verification)
• Storing app settings in Saleor metadata
• Building Dashboard UI inside the iframe
• Making GraphQL calls with app tokens
• Debugging webhook failures, auth errors, or permission issues
• Deciding who can view the app and what they should see (user vs app scope)

Rule Categories by Priority

| Priority | Category | Impact | Prefix |