New admin.app.home.render target lets you build your app's landing page (App Home) as a Preact-based admin UI extension. It ships in the same bundle as your other admin UI extensions, so you no longer need a separate web server to render App Home.
admin.app.home.render target was added, so you can now build App Home as a
Preact-based admin UI extension. Because it ships in the same bundle as your other admin UI extensions,no separate web server is needed to render App Home.
App Home was provided as a separate web app and embedded in the Admin via an iframe. Running and hosting a server was required just for the landing page.
admin.app.home.render describes App Home as a UI extension. It ships alongside your other admin extensions, giving you the performance and design benefits of Polaris web components without a server.
The three conditions the article lists for "when you want to use this extension type."
When, instead of a web app hosted in a separate iframe,a permanent full-page workspace integrated into the extension bundleis what you want.
When you want to manage the app's main UIas a single source of truth alongside other admin UI extensionsthe way you'd manage them.
When, without hosting a web server for App Home,the performance and design-system benefits of Polaris web componentsare what you want.
| Item | Details |
|---|---|
| Supported API version | 2026-07 and later The App Home UI extension is available from this version |
| Intended app type | Custom-distribution apps For custom-distribution apps |
| Public apps (App Store) | Out of scope Public apps for the Shopify App Store should continue to use the iframe-based App Home instead |
Scaffold an extension-only app. In the prompt, "Build an extension-only app" select.
To add an App Home UI extension to an existing app, in the prompt, "App home" select.
For the full list of target APIs, web components, and configuration options, see App Home UI extension reference for details.
admin.app.home.render target. Detailed APIs, available web components, and configuration options are all consolidated in the official App Home UI extension reference.An admin UI extension built on Preact that renders App Home at the admin.app.home.render target. You no longer need to maintain the frontend as a standalone web app inside an iframe.
You no longer need a separate web server just to render App Home. For the landing page, the operational burden of hosting, scaling, and monitoring is eliminated entirely.
App Home goes into the same bundle as other admin UI extensions such as block and action. Deployment and versioning are unified at the extension-bundle level.
You get the performance and design-system benefits of Polaris web components without server hosting. It's straightforward to build a UI consistent with the admin.
Available for API version 2026-07 and later, and custom distribution apps.Public App Store apps continue to use the iframe-based App Home. Adoption depends on the distribution model, so determine the project type first before starting design.
admin.app.home.render Migrate to a UI extension and bundle it alongside the other admin extensions.shopify app generate extension It can be added to an existing app via "App home."shopify app init Use "Build an extension-only app" to scaffold an extension-only app and standardize an internal template that handles everything up to App Home as an extension.admin.app.home.render Preact-based UI extension.