App Intents Now Open Full‑Page in Shopify Admin – What Developers Need to Know

Shopify has quietly shifted the way app intents declared on the admin.app.intent.link target are presented in the admin. Where merchants once saw a modal overlay, they now navigate to a full‑page view of your app’s URL. This change aligns app intents with Shopify’s native intent experience and eliminates the cramped overlay for most use cases. In this post we break down the update, identify who needs to pay attention, and give you a checklist to ensure your extension stays smooth.

What Changed

Previously, any intent declared with the admin.app.intent.link target opened in a modal overlay on top of the merchant’s current page. The new behavior launches a full‑page navigation to the URL you defined in your shopify.extension.toml. The only exception is when the merchant has unsaved changes on the current page – Shopify will fall back to the overlay to protect their work. The contract between Sidekick and your app remains unchanged: you still read the payload from shopify.intents.request.value, register tools with shopify.tools.register, and resolve the intent with shopify.intents.response.* calls.

Who Is Affected

Developers who ship an admin _link_ extension with the admin.app.intent.link target. The change applies to every API version and every store—no feature flag, scope, or opt‑in required.

Merchants are not directly responsible for the change, but they will notice a different navigation experience when they trigger your app intent.

Extensions that target admin.app.intent.render are untouched and will continue to render as overlays.

Apps that do not declare any app intents are unaffected.

If an app declares both admin.app.intent.link and admin.app.intent.render, only the link intent changes.

Why It Matters

A full‑page view gives merchants the entire screen real estate of your app, letting you build richer layouts, complex forms, or dashboards that would feel cramped in a modal. It also makes the experience consistent with Shopify‑native editors, reducing cognitive friction. For developers, the shift means you should verify that your intent route works well both as a full page and, in the edge case of unsaved changes, as a modal.

What Developers Need to Do

Good news: no code change is required to keep the intent functional. However, you should perform a quick audit to make sure the UI behaves correctly in the new context. Follow this checklist:

Confirm the route renders as a standalone page – Open the URL defined in shopify.extension.toml directly (e.g., /app/campaigns/123/edit) and verify it uses the full width of the admin.

Maintain modal compatibility – Simulate a merchant editing a product, leave the form dirty, and trigger the intent. The overlay fallback should still look good.

Read the invocation payload – Your page must still read shopify.intents.request.value as a live signal. No change to the API surface.

Register tools on mount – Ensure shopify.tools.register runs when the page loads so Sidekick can invoke your tools.

Resolve the intent – Call shopify.intents.response.ok() or the appropriate error/closed response once the merchant finishes.

Test in a dev store – Use shopify app dev to launch the intent from Sidekick and watch the navigation flow.

Update any overlay‑specific CSS – If you previously scoped styles to a narrow modal container, broaden them for full‑page use.

Example Manifest Declaration

[[extensions.targeting]]

target = "admin.app.intent.link"

url = "/app/campaigns/{id}/edit"

tools = "./tools.json"

instructions = "./instructions.md"

Run shopify app dev in your extension folder.

In the admin, open Sidekick, locate your app action, and click it while on a clean page – you should see a full‑page redirect.

Without saving any changes on a form, click the same action – the modal fallback appears. Verify the payload and tool registration still work.

Check the console for any errors related to missing layout elements or CSS that assumed a modal container.

Once everything looks good, push the update to your production app. No version bump is necessary because the behavior is version‑agnostic.

Conclusion & Next Steps

Shopify’s move to full‑page navigation for admin.app.intent.link intents delivers a smoother, more immersive experience for merchants while keeping the developer contract unchanged. Take a few minutes to verify your intent route, adjust any overlay‑specific styling, and test the fallback scenario. Once confirmed, you can confidently let merchants use your app actions without worrying about cramped modals.

Ready to upgrade your app’s user experience? Start testing today, share your findings with the Shopify dev community, and keep an eye on future Sidekick enhancements. Need help or have questions? Drop a comment below or reach out in the Shopify Developers Discord.