Sidekick Now Invokes App Intents Without Tools – What Developers Need to Know

Shopify’s Sidekick can now surface intent‑only extensions, eliminating the need for a tools file. Learn which apps are affected, how validation changes, and the exact steps to keep your app deployable.

Sidekick Now Invokes App Intents Without Tools – What Developers Need to Know
6 sections

Shopify’s latest developer changelog removes a long‑standing hurdle for Sidekick extensions. If your app registers an admin.app.intent.link or admin.app.intent.render extension without a tools file, Sidekick will now surface it automatically. This seemingly small shift has practical implications for validation, deployment, and the overall developer workflow.

What Changed?

Previously, an extension had to declare a tools section to be considered “Sidekick‑eligible.” As a result, extensions that only declared intents were ignored by Sidekick, and merchants never saw the app suggested for relevant actions. The new update expands eligibility: an extension is now Sidekick‑eligible if it declares tools, intents, or both. The configuration syntax remains unchanged; the existing [[extensions.targeting.intents]] block is sufficient on its own.

Who Is Affected?

  • Developers with intent‑only extensions – If your app contains at least one extension that declares intents but no tools file, that extension will instantly become visible in Sidekick. However, your next shopify app deploy will fail validation unless you add an extensions_summary field to shopify.app.toml.* Developers whose extensions already include tools – No change. Those extensions were already eligible and already required an extensions_summary, so the update does not impact them.* Apps without Sidekick extensions – Unaffected. The rule only applies to extensions that target Sidekick.The change is universal: it applies to every store, has no API‑version gate, and does not require any new permission or preview opt‑in.
  • What You Need to Do

    For the majority of apps, nothing changes—just verify that you’re not missing the new extensions_summary field. Follow these steps before your next deploy:

  • Audit your extensions – Open every shopify.extension.toml in the project. Look for a [[extensions.targeting.intents]] block under the admin.app.intent.link or admin.app.intent.render target that does not have a corresponding tools section.
  • Add an extensions_summary – If any intent‑only extensions exist, ensure your shopify.app.toml contains an [sidekick] section with an extensions_summary string. This summary is what Sidekick shows to merchants when they invoke the intent.
  • Run a test deploy – Execute shopify app deploy against a development store. The CLI will now validate the presence of extensions_summary and alert you if it’s missing.
  • Validate in Sidekick – Open the store’s admin, invoke Sidekick (⌘ K or the “Help” icon), and type a phrase that matches one of your registered intents. Your app should appear in the suggestion list.
  • Example: Adding an extensions_summary

    Below is a minimal shopify.app.toml snippet that satisfies the new validation rule:

    toml

    [app]

    name = "Review Genie"

    api_key = "YOUR_API_KEY"

    [sidekick]

    extensions_summary = "Search and analyze product reviews, create review request campaigns, and manage review display settings"

    If you already have a [sidekick] section, simply add or update the extensions_summary field. The string should be concise (under 150 characters) and clearly describe the value the intent provides to merchants.

    Testing Your Changes in Practice

    After deploying, open a store admin and type a keyword that matches your intent (e.g., “analyze reviews”). If everything is set up correctly, Sidekick will suggest your app, and selecting it will launch the registered admin.app.intent.render extension. This end‑to‑end test confirms that:* The intent is registered and discoverable.* The extensions_summary is being read by Sidekick.* No validation errors appear during deployment.

    Conclusion & Next Steps

    Shopify’s decision to let Sidekick surface intent‑only extensions removes an unnecessary barrier and makes app actions more discoverable for merchants. For most developers, the only actionable item is to verify that an extensions_summary exists for every intent‑only extension to avoid deployment failures.Take a few minutes today to audit your shopify.extension.toml files, add the missing summary if needed, and run a test deploy. Once you’ve confirmed Sidekick can suggest your app, you’ll unlock a smoother, more integrated experience for merchants looking to automate workflows through app intents.If you have questions or need a hand updating your config, drop a comment below or reach out on the Shopify Community forums. Happy building!

    Tags
    Sources

    Related Articles

    Local Delivery Orders Now Available Directly in Shopify POS

    Local Delivery Orders Now Available Directly in Shopify POS

    Shopify POS 11.16+ lets staff create local delivery orders at checkout, using existing delivery zones and rates. Learn what changed, who’s impacted, and how to enable this feature today.

    September 28, 20265 min
    Unlock Deeper Insights: Use Metaobject Fields Directly in Shopify Analytics

    Unlock Deeper Insights: Use Metaobject Fields Directly in Shopify Analytics

    Shopify now lets you pull metaobject data—like designer country, warranty terms, or loyalty tiers—into Analytics reports. Learn what changed, who it impacts, and how to enable and use this powerful new feature.

    September 28, 20264 min
    Category Metafields Now Power Your Shopify Analytics

    Category Metafields Now Power Your Shopify Analytics

    Shopify merchants can finally see category attributes like color, material, and fit directly in Analytics. Learn what changed, who it impacts, and how to start using these new dimensions today.

    September 28, 20264 min
    WebMCP Brings Browser Agents Into the Checkout Flow

    WebMCP Brings Browser Agents Into the Checkout Flow

    Shopify’s new WebMCP support lets browser agents read and update checkout data in real‑time, enabling smarter automation and seamless buyer experiences. Learn what changed, who it impacts, and how to implement it today.

    September 28, 20263 min