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

    Test Your Apps Early: Opt‑In to Admin API Token Expiry from the Dev Dashboard

    Test Your Apps Early: Opt‑In to Admin API Token Expiry from the Dev Dashboard

    Learn how to enable the new Admin API token expiry setting in the Shopify Dev Dashboard, why it matters for public apps, and step‑by‑step actions to test and validate your migration before the April 1, 2027 enforcement deadline.

    November 16, 20264 min
    How Shopify’s New Bot Detection Improves Cart & Checkout Analytics

    How Shopify’s New Bot Detection Improves Cart & Checkout Analytics

    Shopify’s latest update enhances bot detection for cart and checkout activity, giving merchants clearer insights and developers new data handling considerations. Learn what changed, who’s impacted, and how to adapt your reports and integrations.

    November 16, 20264 min
    App Security Update: Mandatory IP Allowlist, Bulk Ops Changes, and Upcoming MFA for Shopify Partners

    App Security Update: Mandatory IP Allowlist, Bulk Ops Changes, and Upcoming MFA for Shopify Partners

    Shopify now requires all public apps that call the Admin API to enable an IP allowlist by Nov 20 2026, tightens bulk‑operations rules, and will enforce MFA for partner accounts. Learn who’s impacted and how to comply today.

    November 14, 20264 min
    Unlock Transparency: The New Store Activity Log Lets You Track Every Change

    Unlock Transparency: The New Store Activity Log Lets You Track Every Change

    Shopify’s rebuilt Store activity log centralizes every modification—from products to payments—into one searchable timeline. Learn what’s new, who can see it, and how merchants and developers can act today.

    November 13, 20264 min