[Bug] Customer Account UI Extension does not render in dev preview

[glamstyle1969]

Please confirm that you have:

• Searched existing issues to see if your issue is a duplicate. (If you’ve found a duplicate issue, feel free to add additional information in a comment on it.)
• Reproduced the issue in the latest CLI version.

In which of these areas are you experiencing a problem?

App

Expected behavior

After the shopify app dev command starts the local server successfully and without any build errors, the new extension should be visible and accessible in the customer account preview.

Specifically:

1. A new navigation link should appear in the account page's menu. The text of this link should match the label property in the extension's shopify.extension.toml file.
2. The main /account page should load without redirecting to /account/orders.
3. Clicking the new navigation link should take the user to the new page (e.g., at /account/points).
4. This new page should correctly render the content of the React component from the extension's src directory.

Actual behavior

Describe the bug

After a completely successful setup process (npm init, shopify app dev runs without errors), the Customer Account UI extension does not appear in the preview.

• The dev server starts successfully and shows the preview URL.
• The terminal shows no build errors for the extension.
• However, when opening the preview, the extension link/block is not present in the customer account page's HTML source (the menu-data does not include the extension).
• Accessing /account redirects to /account/orders.

This happens even after trying to render both a full page (customer-account.page.render) and a block on the index page (customer-account.index.render).

Reproduction

1. Run npm init @shopify/app@latest -- --package-manager yarn
2. Choose Remix & JavaScript.
3. cd into the new project.
4. Run shopify app generate extension.
5. Choose "Customer Account UI" and any template (e.g., Full page).
6. Run shopify app dev.
7. Open the preview. The extension is not visible.

What we've already tried

We have performed extensive troubleshooting, including:

• Resolving all macOS EACCES permission errors.
• Using yarn to fix ERESOLVE dependency conflicts.
• Creating a new Shopify Partner account and a new dev store.
• Re-authenticating the CLI with shopify auth logout.
• Deleting the app from the Partner Dashboard and re-creating it with shopify app dev --reset.
• Manually fixing package.json dependencies for the extension.
• Completely reinstalling all node_modules with yarn install.
• Restarting the dev server multiple times.

Despite the dev server reporting a successful build, the extension is never injected into the customer account page. This seems to be a platform or CLI bug.

Environment information

shopify version
3.81.2
node -v
v22.16.0
npm -v
10.9.2
yarn --version
1.22.22

• OS: macOS

Verbose output

Verbose output

Paste the output here!

Reproduction steps

Operating System

Mac OS 14.6.1

Shopify CLI version (shopify --version)

3.81.2

Shell

No response

Node version (run node -v if you're not sure)

No response

What language and version are you using in your application?

No response

[github-actions]

This issue seems inactive. If it's still relevant, please add a comment saying so. Otherwise, take no action.
→ If there's no activity within a week, then a bot will automatically close this.
Thanks for helping to improve Shopify's dev tooling and experience.

P.S. You can learn more about why we stale issues here.

[gonzaloriestra]

Hi! Sorry for the late response, we missed this one... Are you still facing this issue? If so, you can reopen it and I'll ensure we will check it.

[pgoforth]

@gonzaloriestra This is still an issue.

[github-actions]

This issue seems inactive. If it's still relevant, please add a comment saying so. Otherwise, take no action.
→ If there's no activity within a week, then a bot will automatically close this.
Thanks for helping to improve Shopify's dev tooling and experience.

P.S. You can learn more about why we stale issues here.

[pgoforth]

After going through everything with support, I do not believe this issue exists any longer. There were three reasons we could not see the UI on the Customer Account page:

1. Generic HTML cannot be rendered through an extension. You MUST use the exported nodes from the appropriate extension library.
2. There is a different library of exported nodes for the Customer Account page. You cannot re-use components you have built for the Checkout page, because the checkout library (even though the components are named the same) is completely different.
3. If the Customer Account page is on Shopify's domain instead of a custom domain, there are certain APIs that are unavailable, and cause any conditional rendering to fail.

[gonzaloriestra]

I'm glad you finally solved it. Sorry for not being able to help here, we should have redirected you to Support because it wasn't easy to reproduce and required an investigation with you.

And thanks for explaining here the causes!