Admin Menu Not Showing in Shopify Remix App – Any Ideas?

App Bridge
,
1

Hey everyone,
I’m building a public app using the Shopify Remix template. Everything is mostly working fine, but I’ve run into an issue where the app doesn’t show up in the Shopify admin sidebar menu after installation.

Has anyone experienced this? What could be the possible causes for the admin menu not appearing, and how can I fix it?

Some context:

  • It’s a public app using the latest Shopify Remix template.
  • OAuth and billing flows are working correctly.
  • App loads fine if I access it directly via the URL (e.g. /apps/my-app), but there’s no link to it in the Shopify admin menu.

Any tips or solutions would be much appreciated!

1 Like
2

Hey @The_Sanjay

By default, apps aren’t pinned to the sidebar. The merchant using your app will need to manually pin it themselves. To pin an app, they need to open the app from their admin first, then click the pin icon to keep it in their list. They can also change its position by clicking and dragging the item, or pin it by dragging it directly to their preferred position in the sidebar after opening it. https://help.shopify.com/en/manual/shopify-admin/shopify-admin-overview?utf8=â#apps-and-channels

3

@KyleG-Shopify Thank you so much for your answer. However, my question is not about the Shopify admin side pin.

In our app, we have a submenu item created from the app side:

image
image696×964 50.6 KB

I’m really sorry—I forgot to include the screenshot in my initial question.

Sometimes, this menu doesn’t show up. I suspect it’s because I added Shopify’s debug script for web vital scores. I think that might be causing an issue with App Bridge, which in turn is affecting the menu display!!

4

Hey @The_Sanjay , thanks for clarifying that the issue is specifically with the submenu.

You mention sometimes it doesn’t show up. In the cases where it doesn’t show up, do you see any errors in the browser console at all?

Can you share a little bit about how you’ve implemented the ui-nav-menu and the debug script? That may help to see if we can replicate on our end.

5

Hi @KyleG-Shopify Than you so much lot for your guidance.

I’m building a Shopify public app using Remix. When I add the following to my app’s <head> to enable Web Vitals debugging:
Remix app root.jsx

`


`

Screenshot from 2025-04-09 17-02-50
Screenshot from 2025-04-09 17-02-501456×512 96.3 KB

App nav menu reference

image
image1920×999 147 KB

…my Remix app’s nav menu disappears, and I get console errors related to App Bridge. Is this script required, or should I use the npm package only? What’s the best practice for initializing App Bridge in a Remix app without breaking layout?

Thanks!

7

Hey @The_Sanjay I tried to replicate your issue but couldn’t reproduce the exact error. However, based on my tests, this appears to be related to your navigation menu implementation rather than the Web Vitals debugging script. I noticed in your screenshots you are using NavMenu as opposed to ui-nav-menu that is expected with app bridge (mentioned here: ui-nav-menu).

1 Like
8

Hey @KyleG-Shopify Thank you so much for your help, and apologies for the delayed response.

We are currently referring to the Shopify Remix app template, which includes a NavMenu component.

Could you please suggest the best way to implement it? I noticed that the debug screen can’t be added to the production app, and it also seems to block click events.

10

Hey Sanjay!

Thanks for your patience while we looked in to this. We haven’t been able to reproduce this issue with the web vitals debug meta tag. The problem isn’t directly caused by the debug script, but could be related to how it’s interacting with other libraries in your app.

For next steps, try checking your Link imports. They should be coming from either @remix-run/react or @shopify/polaris. You might also want to temporarily disable any third-party libraries to see if that resolves the issue, as they could be interfering with how your navigation menu renders.

Let me know if this helps!

11

I have the same issue. My NavMenu has been working fine until I added

<meta name="shopify-debug" content="web-vitals" />
<script src="https://cdn.shopify.com/shopifycloud/app-bridge.js" />

Now my app’s sidemenu has disappeared… All of my imports are either @remix-run/react or @shopify/polaris. Removing the vitals scripts fixes the issue. Did you ever get to the bottom of this?

13

Hey @21O , thanks for sharing. I’ll see what I can find out for you.

Did you make any changes besides adding the metatag?

14

Hi @KyleG-Shopify thanks for getting back to me. I actually fixed it… I had forgotten to add this line:

 <meta name="shopify-api-key" content="%SHOPIFY_API_KEY%" />

Which solved the issue (I suspect the same goes for OP). I’ve loaded it in from my .env file like so:

export const loader = async ({ request }: LoaderFunctionArgs) => {
    await authenticate.admin(request);

    return { apiKey: process.env.SHOPIFY_API_KEY || "" };
};


export default function App() {
  const { apiKey } = useLoaderData<typeof loader>();

  return (
    <html>
      <head>
        <meta charSet="utf-8" />
        <meta name="viewport" content="width=device-width,initial-scale=1" />
        <meta name="shopify-api-key" content={apiKey} />
        <script src="https://cdn.shopify.com/shopifycloud/app-bridge.js" />
        <link rel="preconnect" href="https://cdn.shopify.com/" />
        <link
          rel="stylesheet"
          href="https://cdn.shopify.com/static/fonts/inter/v4/styles.css"
        />
        <Meta />
        <Links />
      </head>
      <body>
        <Outlet />
        <ScrollRestoration />
        <Scripts />
      </body>
    </html>
  );
}

Hopefully this can help someone in the future!

1 Like
15

That being said @KyleG-Shopify, I’ve now been waiting over 2 days for the Embedded app checks. I’ve scoured the forums and have tried everything but nothing seems to help. Any ideas?

Screenshot 2025-07-08 at 22.48.23
Screenshot 2025-07-08 at 22.48.231866×314 34.7 KB

16

Hey, that does seem like a long time for those checks. I’ll send you a DM here right away to get some more specifics from you.