Build App Home as a UI extension

You can now create your app's landing page in App Home as a Preact-based admin UI extension using the new admin.app.home.render target. This means your App Home UI extensions are bundled with your other admin UI extensions, eliminating the need for a separate web server to render your app's primary workspace.

Use this extension type when you want:

• A persistent, full-page app workspace that's integrated into your extension bundle, rather than a separate iframe-hosted web app.
• A unified source of truth for your app's primary UI, alongside your other admin UI extensions.
• The performance and design-system advantages of Polaris web components without the need for hosting a web server for the App Home experience.

Availability

App Home UI extensions are available starting from API version 2026-07 and are intended for custom-distribution apps. If you're developing a public app for the Shopify App Store, you should continue using the iframe-based App Home solution.

Get started

To begin, scaffold a new extension-only app by selecting Build an extension-only app when prompted:

shopify app init

Alternatively, add an App Home UI extension to an existing app by selecting App home when prompted:

shopify app generate extension

For a comprehensive list of target APIs, web components, and configuration options, refer to the App Home UI extension reference.