Error when generating app_home extension

Technical Q&A
1

I am unable to generate a app-home extension I am getting the following error:

image
image736×184 4.62 KB

I am running CLI version @4.1.0

2

Hello, @loop_manuel
The issue isn’t with your Shopify CLI version—it’s already up to date. The problem is that your project’s @shopify/ui-extensions dependency is using an older version that doesn’t support the newly introduced admin.app.home.render target. Updating the package to a compatible release (such as 2026.4.0 or later) should resolve the error by allowing the CLI to recognize the target correctly.

Solution:

  1. Update the Dependency:
    Open the package.json file in your project and update the @shopify/ui-extensions version to the version required by the error message.

“dependencies”: {
“@shopify/ui-extensions”: “^2026.4.0”
}

After making the change, run npm install or yarn install in your terminal to install the updated dependency.

  1. Check API Version:
    In your shopify.extension.toml file, make sure the api_version is set to at least 2026-07, because this extension target is only supported starting from that version.

  2. Clear Cache:
    If the error still persists, delete the node_modules folder, reinstall the dependencies, and then run the shopify app dev command again.
    I hope this will help you.
    Thanks!!

3

The issue is most likely a version mismatch.

Your extension is using the target:

admin.app.home.render

but your installed @shopify/ui-extensions package doesn’t support it.

Fix

  1. Check your package version:
npm list @shopify/ui-extensions
  1. Upgrade dependencies:
npm install @shopify/ui-extensions@latest
npm install @shopify/ui-extensions-react@latest
  1. If you’re really using Shopify CLI 4.1.0, upgrade it:
npm install -g @shopify/cli@latest
  1. Delete and reinstall dependencies:
rm -rf node_modules package-lock.json
npm install

This error usually occurs when the CLI/API version and @shopify/ui-extensions version are not aligned.