Only Sidekick has access to 'admin-app-home-render'?

Extensions
1

I had Sidekick write an app. It worked fine, and the app content was inserted into admin through an ‘admin-app-home-render‘ extension.

But when trying to use the same target from the CLI I got an error saying it’s not recognized.

Will this target be eventually available to apps generated with the CLI? Or is there a different way to have app pages fully hosted within shopify?

Thanks

D

2

Hi @Daniel_G

Could you please provide and attach the specific error message here?

3

Hi Kyle

I’m working on an extension‑only app using Shopify CLI. One of my extensions targets admin.app.home.render – used as a small settings/config page under Admin → Apps → [My app].

It works with something like:
BlockExtension.tsx
import {
Button,
Text,
} from ‘ @shopify/ui-extensions/admin’;
export default extension(‘admin.app.home.render’, (root, api) => {
// …
});

I’d like to use the new Preact + Polaris web components in it.
When trying this code:

shopify.extension.toml
api_version = “2025-10”
[[extensions]]
type = “ui_extension”
name = “Custom Configuration”
handle = “custom-config”
[[extensions.targeting]]
module = “./src/BlockExtension.tsx”
target = “admin.app.home.render”

package.json
{
“dependencies”: {
“preact”: “^10.10.x”,
“@preact/signals”: “^2.3.x”,
“ @shopify/ui-extensions”: “2025.10.x”
}
}

tsconfig.json
{
“compilerOptions”: {
“jsx”: “react-jsx”,
“jsxImportSource”: “preact”,
“target”: “ES2020”,
“checkJs”: true,
“allowJs”: true,
“moduleResolution”: “node”,
“esModuleInterop”: true
},
“include”: [“./src”, “./shopify.d.ts”]
}

BlockExtension.tsx
import ‘ @shopify/ui-extensions/preact’;
import {render} from ‘preact’;
export default function extension() {
render(, document.body);
}
function Extension() {
return (
…

Running shopify app dev falls with:
Type reference for admin.app.home.render could not be found. You might be using
the wrong @shopify/ui-extensions version.
Fix the error by ensuring you have the correct version of
@shopify/ui-extensions, for example ~2025.10.0, in your dependencies.

What am I doing wrong? Is it possible to use Preact here?

Thanks