How can I modify my app to open in a new window instead of Shopify's merchant backend?

Topic summary

Goal: Change a Shopify app’s behavior to open in a separate browser window rather than inside the merchant backend (embedded in Shopify Admin).

Current state: The app currently opens as an embedded app within the merchant backend. The team wants a non-embedded experience, mirroring an approved app that launches in a new window.

Clarification: “Embedded” = the app loads inside Shopify Admin’s interface; “non-embedded” = the app opens externally in a standalone browser window.

Request: Detailed guidance and official documentation on how to switch from embedded to non-embedded, including:

  • Which Shopify docs/settings to follow (with relevant links or screenshots).
  • What changes are required in the app’s code architecture.
  • Troubleshooting advice to correct possible misdirection in development.

References: Two screenshots illustrate the current embedded view and the desired non-embedded result.

Status: No solution provided yet; the poster is seeking community or official assistance and a step-by-step tutorial. The discussion is open/unsolved.

Summarized with AI on January 15. AI used: gpt-5.

In actual comparison, it was found that our app was opened in the merchant backend, but in reality, the effect we wanted was to open it in a new browser window, similar to the application in the second image, without the form of the merchant backend.

In fact, the app effect we have always wanted is not an embedded version. Taking an approved app from the app store as an example, let’s talk about the areas that require official assistance。

This is the rendering of our application opened after installation in the testing store:

This is the rendering of an approved app found in the Shopfiy app store after installation in the testing store:

So, in response to the above issue, we hope to provide a detailed tutorial document for modifying it; For example, the document prompts which part (screenshot, link) of Shopfiy’s official document needs to be compared for adjustment; Or what modifications need to be made to our existing APP code architecture; Or provide detailed documentation to answer any issues such as errors in our development direction.

Can kind-hearted people passing by help me? Thank you very much.